Theming Advice

156 views
Skip to first unread message

Bravismore Mumanyi

unread,
Mar 17, 2015, 10:14:40 AM3/17/15
to ica-ato...@googlegroups.com
Dear Atom users

I am trying to play around with the code that generate the resulting HTML for Atom. I have tried making the following changes to "apps/qubit/templates/layout.php" with no luck.

1. add some plain text right at the start of the <body>.
2. include a CSS file
2. rearrange the header (i.e. replace the logo)
3. add/change the footer

All minor changes made so far have no effect on the layout/presentation. I have tried restarting nginx to no avail.

Am I missing the right file to make such changes?

Regards
/Bravismore

Hutchinson, Tim

unread,
Mar 17, 2015, 10:48:14 AM3/17/15
to ica-ato...@googlegroups.com

Hi Bravismore,

 

At a minimum I believe you will need to clear the application cache:

php symfony cc

 

Tim

--
You received this message because you are subscribed to the Google Groups "ICA-AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.
To post to this group, send email to ica-ato...@googlegroups.com.
Visit this group at http://groups.google.com/group/ica-atom-users.
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/CAAEWFHTYRM4vD5O2UH-iSK1-T1r6V2jskj73oYvFYAdqyBOsXw%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.

Kehan Harman

unread,
Mar 17, 2015, 10:52:05 AM3/17/15
to ica-ato...@googlegroups.com

And you will want to be making those changes to a theme rather than the core templates. Try copying the dominion theme and then enabling that through the administration ui. In the theme you can override pretty much any template by just putting it in the correct directory path.


José Raddaoui

unread,
Mar 17, 2015, 1:54:19 PM3/17/15
to ica-ato...@googlegroups.com
Also, the layouts more used in AtoM 2.0 and higher are layout_1col, layout_2col, layout_3col and layout_wide.

Regards.


On Tuesday, March 17, 2015 at 3:52:05 PM UTC+1, Kehan Harman wrote:

And you will want to be making those changes to a theme rather than the core templates. Try copying the dominion theme and then enabling that through the administration ui. In the theme you can override pretty much any template by just putting it in the correct directory path.


On Tue, 17 Mar 2015 10:48 pm Hutchinson, Tim <tim.hut...@usask.ca> wrote:

Hi Bravismore,

 

At a minimum I believe you will need to clear the application cache:

php symfony cc

 

Tim

 

From: ica-ato...@googlegroups.com [mailto:ica-ato...@googlegroups.com] On Behalf Of Bravismore Mumanyi
Sent: March-17-15 8:15 AM
To: ica-ato...@googlegroups.com
Subject: [ica-atom-users] Theming Advice

 

Dear Atom users

 

I am trying to play around with the code that generate the resulting HTML for Atom. I have tried making the following changes to "apps/qubit/templates/layout.php" with no luck.


1. add some plain text right at the start of the <body>.

2. include a CSS file
2. rearrange the header (i.e. replace the logo)
3. add/change the footer

 

All minor changes made so far have no effect on the layout/presentation. I have tried restarting nginx to no avail.

 

Am I missing the right file to make such changes?

 

Regards

/Bravismore

--
You received this message because you are subscribed to the Google Groups "ICA-AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.

To post to this group, send email to ica-at...@googlegroups.com.

Bravismore Mumanyi

unread,
Mar 18, 2015, 9:54:09 AM3/18/15
to ica-ato...@googlegroups.com
Thank you all who responded to this thread.

I have enabled the dominion theme but can't seem to locate the path to the theme's layout and css files.

Please help with direct path to theme design files

Regards
/Bravismore

Dan Gillean

unread,
Mar 18, 2015, 2:22:27 PM3/18/15
to ica-ato...@googlegroups.com
There are a bunch of places in AtoM where CSS files can be found.

For the Dominion plugin, check here:

We are using Bootstrap 2.3.2 with LESS - in the current 2.1.x version of AtoM, any version below LESS 2.0.0 will work. Our installation docs include instructions on installing LESS - one of the dependencies needed for AtoM - but if you haven't yet, you can do it like so:

  • sudo npm install -g "less@<2.0.0"
Generally, if you are making a new theme, our developers usually recommend reading up on the Symfony documentation for creating a new plugin. A good place to start in Symfony plugin documentation might be:
You could technically achieve all of this by copying one of the existing themes (e.g. arDominionPlugin or arArchivesCanadaPlugin), changing its name, and registering it in the application, but you may still run into issues, and you will still need to look up the correct way to register a new plugin. Better to learn more about the framework and follow its practices from the start.

With any CSS changes to an existing plugin or a new one, you will likely need to manually compile the CSS the first time. Here is an example of doing so for the arDominionPlugin:


Navigate to the Dominion theme plugin

  • cd plugins/arDominionPlugin

Recompile the CSS

  • make

Return to your root directory

  • cd ../..

Clear the cache

  •  php symfony cc
Rebuild the search index
  • php symfony search:populate

Restart PHP5-FPM

  • sudo service php5-fpm restart

In terms of other CSS files in AtoM: the base Bootstrap 2.3.2 files can be found in the vendor directory, here:
There are also another place where you will find CSS files in AtoM that are not covered by Bootstrap:


I hope that helps; let us know how it goes!

Dan Gillean, MAS, MLIS
AtoM Product Manager / Systems Analyst,
Artefactual Systems, Inc.
604-527-2056
@accesstomemory



Bravismore Mumanyi

unread,
Mar 19, 2015, 4:32:32 AM3/19/15
to ica-ato...@googlegroups.com
Well appreciated

Seems to have gotten a handle on it now

Regards

Reply all
Reply to author
Forward
0 new messages