Since 1.12.0 the website's logo for light backgrounds, its logo for dark backgrounds, the favicon and the brand colour are set once, on Setup › Business profile. The website, emails, invoices, quotes and payslips use them from there, and the Content Manager's Brand Assets screen shows the same pictures. This page describes WBAMS's own marks and the media library.
Logo system
Use the full WBAMS wordmark in frontend and control-area headers and footers. The icon alone is reserved for favicons, compact launchers, application tiles, and spaces where the wordmark cannot remain legible. The icon should visually align with the height of the WBAMS wordmark.
Light and dark assets
wbams-logo-on-light.pngfor light surfaces.wbams-logo-on-dark.pngfor dark surfaces.- Icon sizes from 16×16 through 1024×1024 for browsers, devices, and applications.
Footer logo assets
Open Content Manager › Footer Layout (the Footer Settings page) and find Brand Identity. The default Same as Header choice keeps the header light/dark branding pair synchronized with the footer. Choose Different Footer Logo only when the footer needs a distinct treatment, then select the light footer logo and optional dark footer logo from the Media Library.
WBAMS preserves safe output when custom fields are incomplete. If custom mode has no light footer logo, Serepok uses the header branding pair. If the custom light logo exists but the dark logo is blank, Serepok uses the custom light logo in both color modes. Keep the custom light asset legible on both surfaces when relying on that fallback.
Since 1.12.0 Footer Layout also sets Links per Column: a column with more links ends in a More link that opens the rest, and 0 shows every link. Link Icons shows or hides the icons beside the column headings and links.
Fresh installs and upgrades default to Same as Header. The 1.1.1 updater adds missing footer-logo settings idempotently and preserves existing setting values when it is run again.
Media library
The media library holds the pictures, video and documents used across WBAMS. Select an asset, verify its preview, add descriptive alternative text, and use optimized dimensions. Keep filenames lowercase and descriptive.
Open it from Content Manager › Media Library, or from any picture field. It has these collections:
Select a file to see its details at the bottom of the library, with these actions:
Replace, Rename and Delete are offered for Uploads, Site media and Documents only, to administrators whose role may configure general settings or manage the knowledgebase.
Where a file is used
Since 1.9.5 the library reads every content table, and the theme files, for the address of each file, in every form a picture is stored in: the library's own path, a full address, a path from the site root, JSON with escaped slashes, and the location used before 1.8. Logs, revisions and other history are left out, so a picture mentioned in last month's activity log does not count as used, and so is the dashboard's widget cache. System settings are named in plain words — Logo, Webmail logo, Sign-in page · Background image — rather than by their keys. Links to PDFs are found as well.
A file used nowhere carries an Unused mark, and the library can show only files in use or only unused ones, which makes clearing out old uploads safe. The Content Manager's own picker gives the same warning before it deletes. If the database cannot be read, the library says it could not check and changes nothing, rather than treating every file as unused.
Recently deleted
Deleting no longer erases. A deleted file waits in Recently deleted for 30 days, where it can be restored to its old address with one click — under the next free name if a file of that name has appeared since — or deleted for good. Files older than 30 days are removed on their own. The trash lives in storage/media-trash, which is closed to the web. A deleted document keeps its title.
Documents
Since 1.10.0 the library, opened from the menu, has a Documents tab for papers such as reports, letters and statements that should not be published through Downloads. Documents are PDFs of up to 50 MB, each checked to be a real PDF.
- New folder makes a folder; while a folder is open, anything uploaded goes into it. All documents shows everything, and search also matches folder names.
- A folder can be renamed — only its name changes, so links to the files in it keep working — and deleted once it is empty.
- A document keeps the title it arrived with ("Annual report, January 16, 2014") rather than one rebuilt from its web-safe file name, and renaming it edits that title.
- View, Copy link, Replace, Rename, Delete and Recently deleted work for documents as they do for pictures.
Files are stored under assets/media/documents/<folder>/, which carries the same no-scripts guard as the other media folders and an empty index.html so it cannot be listed. Picture fields elsewhere in WBAMS do not show the Documents tab, and uploads from them still go to Uploads. A Resource List section can point at a document's address.
Thumbnails
Since 1.9.4 the library makes small copies of an image the first time one is needed, and again whenever the image is replaced: 128 pixels for menu pictures and 320 pixels for the library's own grid and the Content Manager's picker, in WebP where the server can write it and JPEG or PNG where it cannot. Images that are already small, SVG files, icons and pictures on other sites are used as they are. The copies live in assets/media/thumbs; the folder can be deleted at any time and refills itself. A thumbnail's address changes when its image does, and the thumbnails of a deleted or renamed image are removed with it. What a field stores is always the original image.
The library accepts only types whose content matches their extension, screens SVG files for script in any spelling, and gives every media folder rules that stop the web server running a script from it and forbid script in an SVG opened on its own. The page builder's upload goes through the library too.
WBAMS image principles
Images should explain the product: connected customer records, plans, invoices, payments, automation, support, and operational signals. Avoid generic decoration that could describe any software. Prefer clear data flows, connected systems, visible outcomes, and trustworthy customer operations.
Keep source masters outside the public media library. Optimize a copy for delivery, record usage, and verify light/dark contrast before replacing a global logo.
The client theme
Draisap is the customer-facing theme and the only order form the product ships. It is self-contained: as of 1.5.0 it inherits from nothing, having previously extended a standard-checkout form that has been removed.
An update replaces the files it ships. Work in a copy and the updater leaves it alone; edit the original and your changes are what the release notes call “overwritten”.
Website themes
Since 1.13.8, Setup › Website themes shows every theme the website has as a card with its picture, and marks the one visitors see (On your website). Preview opens the website with a theme in your own browser only, while visitors keep seeing the current one, and Use on the website makes it the website's theme. General Settings links to the page. The themes that come with WBAMS are marked Part of WBAMS and WBAMS updates look after them; a theme you uploaded can be updated, put back or removed there. See Uploading a theme or an app.