What version of AtoM are you working with? Are you trying to modify the homepage directly, or have you created a custom theme plugin and are trying to override the default homeSuccess file with your own version in the plugin? What elements of the homepage are you attempting to modify (in case they are actually stored in a different file)?
Note that a custom homeSuccess template will override the existing template (i.e. the look and feel used for the page), but the content itself (i.e. your static page content entered on the homepage) is stored in AtoM's database, and will not be affected by a custom theme template. If you're trying to edit the static page content, but the edits aren't showing up, there may be a problem with registering your theme (see below re: the configuration file) - you can also check AtoM's error logs to see if an error is being thrown when trying to save your static page entry:
A few resources for creating and managing custom themes:
Basic instructions and an example for creating a theme plugin can be found in our documentation here:
Be sure to check out the part on creating the configuration file in particular - you need this file for AtoM to know there's a theme plugin!
We also have some slides here - hey are a bit dated but still mostly accurate:
I'm also attaching a PDF that outlines how to install a theme plugin into an existing AtoM implementation. More implortantly, the second half of the document outlines how a theme plugin is typically organized - so you can ensure that your custom homeSuccess file is in the expected place.
Additionally, our Upgrading documentation has a few suggestions for files that may need to be manually modified when upgrading with a custom theme, to ensure everything works as expected. See:
Note that to compile your theme, you may need to install a few dependencies that might not be present if your AtoM instance was originally installed using the downloadable tarball. You will need cURL, make, and lessc installed:
- sudo apt install curl
- sudo apt install npm make
- sudo npm install -g "less@<4.0.0"
Now we can recompile the CSS for the base Dominion theme:
- sudo make -C /usr/share/nginx/atom/plugins/arDominionPlugin
If you have a custom theme plugin, then you will want to repeat this last command, but using the name of your custom theme plugin in place of arDominionPlugin.
Finally, it's possible that the content you want is coming from a different file. Keep in mind that AtoM has separate template files for the header
, and I believe that the homeSuccess file calls the layout_2col
file in some way. So you may want to check these files as well.
Let us know how it goes! Hopefully with a bit more information we can offer further suggestions on next steps.