Oldest known version of this page was edited on 2008-06-17 15:04:11 by craigh [ ]

Installing a Xanthia theme is quite simple. The following instructions are provided for the installation of Xanthia themes only. For more information about the installation of themes made for Autotheme or other third-party theme modules, please visit their respective websites and/or read the documentation provided with your theme. You may also want to read the installation instructions provided with the theme prior to continuing with these instructions.

First Things First

Download and extract your theme. The directory structure of your theme should look something like this:
  • ThemeName
    • docs
    • images
    • lang
      • eng
    • style
    • templates
      • blocks
      • modules

There may be other folders in your particular theme, but this gives you a basic understanding of how it should be laid out. If your theme does not follow this basic layout principle, please check the documentation as it may not be a Xanthia theme.

Uploading Files Via FTP

There are many FTP utilities available for this, many of which are free. You will need to download and install an FTP utility before you can continue with this process. FileZilla is free and recommended.

Now you can FTP your theme to your Zikula site. Make sure you place it in the proper directory on your server or it will not function properly. In the directory structure above, the ThemeName directory would be uploaded into the themes directory on your site. The PN themes directory is located at /themes. As a double-check, your theme would be uploaded into the same directory as the ExtraLite? theme (included with Zikula). There may already be other themes in that directory as well.

Activating Your Theme

Once you have all the files transferred to your Zikula installation, you can make your theme active. Login as Administrator to your Zikula site, go to the Administration area, then go to the Layout Tab and then Theme. You will be presented with a list of themes (Xanthia only) residing in your themes directory. Click the "regenerate themes list" link. If you uploaded your files correctly, your theme should now show up in this list.

Configuration of Your Theme

At this point, you may have some configuration options to tend to before going live with your theme. From the main Xanthia administration page, click on the "Edit theme" link next to your theme. Then click the "Settings" tab to see if there are any theme-specific settings you can change to your liking. However, most of these settings, if existent, will have a default setting that may work fine for you without changing anything.

For more information regarding theme configuration, visit the "Xanthia and Themes" section of the User Documentation in the Zikula Community's Documentation Wiki.

Making Your Theme Live

So you are ready to show your theme to the whole world? Login as Administrator to your Zikula site and go to the Administration/Layout tab area. Click on the Green Checkmark next to your desired theme to make it the default site theme.

User Documentation Homepage
CategoryUserDocs
Last edit:
Latest author:
Owner: Wendell