Sub theming your timebank website

in CW 2 Site-Admins Helping Site-Admins

Here's my description of how to subtheme your timebank website.

 

I have created subtheme of Acquia Marina so that I can modify the appearance.

Currently (20 Feb '12) this is not working as the 'Record an exchange' page is missing the category and date fields. I think an updated tpl file will fix this problem, and am hoping TBUSA will provide. But can't confirm that as yet.

 

 

SUMMARY

To make modifications to the theme you need to have a new copy of the theme installed by FTP, change its name so it does not conflict.

You include the TBUSA special files inside the newly uploaded theme, then activate the new theme and make it default.

You are dependent on TBUSA providing up-to-date special files, and will need to update whenever they change their files.

 

METHOD

1] Upload the theme using FTP

You have to upload the theme into the empty theme folder you see when you FTP.

A copy of the theme can be obtained from drupal.org

 

2] Get the TBUSA modified files

Download the theme files from TBUSA: http://actionhub.timebanks.org/faq/site-admin, at the bottom there are 2 files to download

Hopefully this will become a separate page of its own on the Action Hub, with new sets of files added as changes are made to the TBUSA files.

 

3]  Upload the TBUSA modified files

Change the file name by deleting the last 5 characters:

mc_3rdparty_formspecial.tpl_.php_.txt

becomes mc_3rdparty_formspecial.tpl_.php

Upload the .php file into the theme folder you have uploaded

Upload the css file into the css folder

 

4] Change the name of the uploaded theme

It is currently identical to the TBUSA one already there, and you need to distinguish them from each other.

(i) Change the folder name. I am in Otaki so I changed it to: acquia_marina_otaki

(ii) Change the name of acquia_marina.info  to acquia_marina_xxxxx.info

(iii) Open acquia_marina_xxxxx.info and change the name inside

The file begins:

; $Id: acquia_marina.info 7703 2010-07-14 22:42:55Z jeremy $

name = Acquia Marina

description =

Change

name = Acquia Marina to

name = Acquia Marina xxxxx

 

4a] You could also change the screen shot so it will look different in the theme list within the timebank.

Upload a new screenshot.png with the same dimensions.

 

5] Go back to the website and open the Themes list

 Turn off all the unnecessary themes

Turn on your theme. You will recognise your theme as it has the different name you gave it.

Leave the Acquia Marina theme on  - you always need a fallback theme, and this is it.

To activate your theme, make your theme the default.

6] Theme settings

Replicate the settings from the TBUSA theme to the new theme.

Logo and favicon might need to be uploaded again.

7] Blocks

You will need to replicate the blocks from the TBUSA theme to the new theme.

8] Check out the website with the new theme

You need to do some serious roaming around and trying things to make sure everything is working. 

You need to be available to fix things that other people find in the days following your change. (Took me a while to realise that the 'Record an excahnge' page was broken in my modified theme).

9] Modifying the css

I add all my extra css to the bottom of the file.

This leaves the TBUSA modifications intact. 

This is important, as when they change their css, it can be be pasted down into this file again without affecting the changes I have made.

As my changes come after the TBUSA lines they will override.

I also mark where my changes start, and put a date (which I update) when I make changes.

10] If disaster strikes

Switch back to the TBUSA theme until you work out what the problem is.

 

Updating when TBUSA changes its files

CSS

Open the new TBUSA css file and copy its lines.

Open the file in your theme and replace all the TBUSA lines with the new lines.

Check your timebank website to see if you need to fix, change or update any of your modifications.

TPL

Either replace the TBUSA tpl file with the new one, or add extra files if they provide extra ones.

Blocks

Check if there have been any changes.

SUMMARY

To make modifications to the theme you need to have a new copy of the theme installed by FTP, change its name so it does not conflict.

You include the TBUSA special files inside the newly uploaded theme, activate it and make it default. You update theme and block settings in the new theme.

 

You are dependent on TBUSA providing up to date special files, and will need to update whenever they change their files.