Using theme overrides, experienced web developers can customize existing Wild Apricot themes or create new ones. Theme overrides involve replacing or overriding theme files – the files that control the appearance and behavior of your current theme. Typically, your override files will include code to customize a feature or element of your theme.
You can also customize the appearance and behavior of your Wild Apricot site in other ways:
Glossary of terms
To better understand the theme override process, you need to become familiar with the following terms:
Activating theme overrides
To activate theme overrides:
Now that you have downloaded and unzipped the theme files, you can modify them and upload your changes to customize an existing theme, or make a copy of them to create a new theme.
Customizing vs creating a theme
There are two approaches to using theme overrides to customize your site: customizing an existing theme, and creating a new theme.
The simplest approach is to customize an existing theme. This is what happens by default when you enable theme overrides. For instructions, see Customizing theme files (below).
If you want to create theme from scratch, you can create a new folder in WebDav – or copy an existing theme structure – and start creating the theme. You can set the theme parent to one of our themes, or create a standalone theme. You can refer to the Theme inheritance diagram if you want your theme to inherit from one of our theme prototypes.
Customizing theme files
Once theme overrides are enabled, a Theme_Overrides folder will be added to your Resources folder on your site. The Theme_Overrides folder contains the same folder structure as the downloaded theme files, but the folders themselves are initially empty.
To customize your theme, follow these steps:
Theme override errors
If your override files contain errors, your theme could malfunction, and the appearance and/or accessibility of your site may be affected.
All theme override errors will be logged in the Theme_Overrides\Log folder, accessible through WebDAV.
When a theme override occurs, you can correct the problem by logging in as an administrator and going to the Theme overrides screen.
The Theme overrides screen will display a message for each error, with links to the error log files.
You can correct problems by deactivating theme overrides entirely, disabling individual overrides, or rebuilding the theme files.
Deactivating theme overrides
To deactivate theme overrides, click Disable theme overrides. The original theme settings will be restored.
Disabling individual overrides
The Theme overrides screen lists all override files currently in use on your site.
To disable an individual theme override, click the Delete button to the right of the override file name. This will delete the override file from your site, but not from the downloaded theme files on your computer or network.
Rebuilding theme files
Sometimes a theme file isn't compiled correctly, leading to a site malfunction. Clicking the Rebuild theme button will re-compile the override files. You should also rebuild the theme after uploading a theme override file.