FAQs Omeka Classic theme

Troubleshooting

Why don't the colors look exactly like the palette?

Confetti darkens or lightens a color wherever text in that color, or on that color, would be hard to read, keeping its hue.

Can I use my own brand colors?

Confetti keeps its colors to its four palettes. To fine-tune them, use Advanced › Custom CSS with the design tokens (see Custom CSS and design tokens). For full control of brand colors, the Vitrine theme offers them as settings.

Why are there fewer settings than in Vitrine?

Confetti sets most of its design itself, so a site looks right with a palette and a logo. Its pages, content classes and plugin styles are the same as Vitrine's.

How do I make the site quieter?

Set Colors & fonts › Decorations to Calm: the confetti, squiggles and stars go away, and the shapes and colors stay.

My logo, banner or icon won't upload.

The Configure Theme page accepts PNG, JPG and GIF files up to 1 MB: SVG files and larger images are refused, with a message beside the field. Save a smaller PNG or JPG. For a large banner picture, add it to an item and use Home page › Banner image from an item. If even small files fail, your server's PHP upload limit (upload_max_filesize) may be lower than 1 MB: ask your host.

My logo disappears in dark mode.

Add a light version of the logo under Dark mode › Logo for dark mode.

Why does my home page banner look blurry?

A banner taken from an item uses Omeka's full-size copy of its image, at most 800 pixels wide by default. Raise Fullsize Image Size under Appearance › Settings (to 1600 or 2000) and add the image to the item again, or upload a banner image of at least 1600 pixels wide under Home page › Banner image.

A Simple Page lost its content classes when I saved it.

Two things in Omeka rewrite HTML when you save. On a Simple Page with Use HTML editor? ticked, the editor can drop or rearrange the markup a content class needs: untick it for pages built with content classes and edit the HTML directly. And Omeka's HTML filter (Settings › Security) removes elements and attributes that are not on its allowed lists. See Simple Pages and content classes.

Pictures disappear from my page text when I save.

Omeka's HTML filter does not allow img by default. Add img, figure, figcaption to Settings › Security › Allowed HTML Elements and img.src, img.alt to Allowed HTML Attributes, or show pictures with the [file id=12 size=fullsize] shortcode, which the filter leaves alone.

The home page shows no featured items, collections or exhibits.

Only records marked Featured and Public appear: tick both on the item's, collection's or exhibit's edit page. Featured exhibits need the Exhibit Builder plugin, and the number to show under Home page must not be Hide.

My settings don't apply to an exhibit.

The exhibit has a theme of its own: on its edit page, Exhibit Builder's Theme is set to a theme rather than Current Public Theme, and its settings replace the site's on its pages. Change them there with Configure, or choose Current Public Theme. See Exhibits.

I changed settings in Design Studio, but visitors don't see them.

Design Studio keeps your changes as a draft that only you see until you click Publish.

The site still looks the same after I changed something.

Settings take effect as soon as you click Save Changes. If you still see the old design, your browser, a caching plugin, a proxy or a CDN may be showing a stored copy: reload the page while holding Shift, or clear that cache.

The site loads a script from code.jquery.com.

Omeka Classic itself loads jQuery from code.jquery.com on every public page, whatever the theme. To serve Omeka's own copy instead, set theme.useInternalAssets = true in application/config/config.ini. Confetti adds no other outside requests: its fonts are served from your site.

Where do I choose what appears on item pages?

Under Item pages in the theme's settings. See Browse and item pages and Item and file pages.

Why is my link preview on social media missing an image?

Upload a Default sharing image under Site icon & sharing. Social networks keep previews for a while; their sharing debuggers can refresh them.

How do I show the site in my language?

See Languages and translation.

A plugin's page doesn't match the theme.

Many plugins have templates or styles in the theme: see Plugin integrations. Every other plugin's pages inherit Confetti's text, forms and buttons. If something looks out of place, adjust it under Advanced › Custom CSS using the design tokens, and tell RefBytes which plugin and page it is.

Log in for Support