Sitemapper_XH - a CMSimple_XH Plugin

Plugin Icon

Sitemapper_XH automatically creates an XML-Sitemap of your CMSimple_XH installation. For detailed information about Sitemaps see sitemaps.org.

Please do read this documentation, before you encounter any problems!

Important Notice

Sitemapper_XH couldn't be tested so far in various environments. It is a so called BETA version. Use with caution!

Requirements

Sitemapper_XH is a plugin for CMSimple_XH. It requires a UTF-8 encoded version.

Installation

The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.

  1. Backup the data on your server.
  2. Unzip the distribution on your computer.
  3. Upload the whole directory sitemapper/ to your server into the CMSimple_XH plugins directory.
  4. Set write permissions for the subdirectories config/ und languages/.
  5. Switch to "Sitemapper" in the back-end to check if all requirements are fulfilled.

Settings

The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select "Sitemapper" from "Plugins".

You can change the default settings of Sitemapper_XH in "Config". Hints for the options will be displayed when hovering over the help icons with your mouse. The most important setting is canonical hostname. You should enter the preferred way of calling your domain, i.e. www.example.com or example.com, if that is not already handled correctly by the server configuration.

Localization is done in "Language". You can translate the character strings to your own language or customize them according to your needs.

Usage

To activate the plugin you have to insert the following line at the very beginning of your template(s):

<?php sitemapper();?>

Sitemapper_XH makes Sitemaps of your website available. There is a Sitemap index file, and additional Sitemap files for each installed language and subsite. All published pages that are not hidden will be included in the Sitemap. Additionally hidden pages will be included when "ignore hidden pages" is set to "0". You can view the generated Sitemaps in the plugin administration in "Sitemaps".

The simplest way too make the Sitemap available to search engines is to put the following line to your robots.txt:

Sitemap: http://www.example.com/?sitemapper_index

Of course you have to adjust the URL to your domain name (it's best to just copy and paste the URL to the Sitemap index file from the plugin administration). Another possibility is to submit your Sitemap to search engines directly (e.g. via the Google Webmaster Tools).

It is possible to override the default settings of "changefreq" and "priority", which are defined in the plugin config, for each page in the pagedata tab "Sitemap" above the editor. For details on this settings, see XML tag definitions.

Limitations

Sitemapper_XH will only list the actual pages of CMSimple_XH's content. Additional content that is managed by plugins, e.g. forums or blogs, will not be included to the Sitemap file.

License

Sitemapper_XH is licensed under GPLv3.

© 2011-2013 Christoph M. Becker

Czech translation © 2011-2012 Josef Němec
Polish translation © 2012 Kamill Krzes
Slovak translation © 2012 Dr. Martin Sereday

Credits

Sitemapper_XH was inspired by Simmyne.

The plugin icon was designed by Wendell Fernandes. Many thanks for publishing this icon as freeware.

This plugin uses free applications icons from Aha-Soft. Many thanks for making these icons freely available.

Many thanks to the community at the CMSimple_XH-Forum for tips, suggestions and testing. Particularly I want to thank Ulrich for being the first beta tester of Sitemapper_XH. And many thanks to sareide, who detected a severe bug regarding the URLs of subsite/second language pages.

Last but not least many thanks to Peter Harteg, the "father" of CMSimple, and all developers of CMSimple_XH, without whom this amazing CMS wouldn't exist.