PostNuke: A Flexible Open Source Content Management System
home | forum | international support | contact us

Documentation Wiki

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 PostNuke 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 PN site. The PN themes directory is located at PNroot/themes. As a double-check, your theme would be uploaded into the same directory as the ExtraLite theme (included with PostNuke). There may already be other themes in that directory as well.

Activating Your Theme

Once you have all the files transferred to your PostNuke installation, you can make your theme active. Login as Administrator to your PostNuke site, go to the PN Administration area, then go to Xanthia administration. You will be presented with a list of themes (Xanthia only) residing in your themes directory. If you uploaded your files correctly, your theme should show up in this list.

Now you need to add your theme, which makes it available for use on your site. Click the "Add theme" link next to your theme. If all goes well, PostNuke will present you with the following message:

The theme was successfully added to the database. To begin configuring this theme,
you must first select it in the settings administration panel and then edit it from the Xanthia administration panel.

It is also recommended that you click the "View theme" link after adding it to make sure it looks like it's supposed to. The preview will open in a new window and will use your site's homepage for content. If all looks well, move on to the next step. If not, you should check to make sure you uploaded all files properly and that they all transferred without errors.

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 PostNuke 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 PostNuke site and go to the PN Administration area. Click on "Settings" and scroll down to the "Themes" section. Select your theme from the dropdown window, then scroll to the bottom of the page and click the "Save Changes" button. Your theme should now be active.


User Documentation Homepage

CategoryUserDocs
XML Revisions of $tag
Page history :: Last Editor [ markwest ] :: Owner [ Wendell ] ::
Valid XHTML :: Valid CSS :: Powered by pnWikka 1.0 (A wiki fork from WikkaWiki)
 

Main Menu

Extensions Database

Documentation

Development

Login





 


 Log in Problems?
 New User? Sign Up!

Donate to PostNuke