XML Sitemap

Darren Oh - November 9, 2007 - 18:40

XML Sitemap automatically creates a site map that conforms to the sitemaps.org specification. This helps search engines keep their search results up to date.

XML Sitemap replaces the Google Sitemap module written by Matthew Loar as part of Google Summer of Code 2005. Please check there for older versions.

The code has been written to allow external modules to add support for new link types and search engines. The following optional modules are included in XML Sitemap:

XML Sitemap: Engines
It allows to submit the site map to the major search engines.
It supports the following search engines:
XML Sitemap: File
(Version 5.x-2.x and higher) Adds node attachments to the site map.
XML Sitemap: Menu
(Version 5.x-2.x and higher) Adds menu items to the site map.
XML Sitemap: Node
Adds nodes links to the site map.
It now includes the ability to create site maps with Views, including Google News site maps (Drupal 5 branch only). This feature was sponsored by EmpowHer.com: Strong Women Transforming Health.
XML Sitemap: Term
Adds taxonomy terms links.
XML Sitemap: User
Adds user profiles links.

Requirements

Version 5.x-1.6, and 6.x-0.x-dev require PHP4, or PHP5 with zlib extension installed, and configured.

Integration with third parties modules

Known issues

  • Users who have not enabled clean URLs have reported receiving an Unsupported file format error from Google. The solution is to replace ?q=sitemap.xml at the end of the submission URL with index.php?q=sitemap.xml, or to enable the clean URLs.
  • On rare occasions Drupal doesn't properly run the installation script for modules.
    Disable the XML Sitemap modules on the modules page, and uninstall them; then re-enable them.

Updating / upgrading

Updating / upgrading to any version
  • When you are installing a new version, be sure to delete the files of the old version files, before to copy the new version ones.
  • Verify that there aren't duplicates of files. This can happen, i.e., if the new version places the files in a subdirectory that didn't exist before; but it can also happen if you installed the previous version in a directory different from the directory where you installed the latest version.
  • If you are updating XML Sitemap, be sure to always execute the update of Drupal through update.php; if update.php is not executed, the database tables are not being updated, and this will cause SQL query errors provoked by the difference between the fields name used by the code, and the name of the fields really present in the database.
  • After updating XML Sitemap, visit /admin/reports/status, and verify there aren't warning (or error) messages given by XML Sitemap; if there are any messages, follow what they suggest you to do.
Upgrading to XML Sitemap 6.x-2
  • Be sure the database tables used from the project modules (their name starts with xmlsitemap) are removed from the database.
    The project modules don't contain the code to update from previous versions, but contain the necessary code to rebuild the content of their tables from the content of the Drupal core tables.

Additional notes

  • The 6.x-1.x-dev, and 6.x-2.x-dev versions are still work in progress to port the code from 5.x-2.x-dev; don't use them in production web sites.
    6.x-2.x-dev has been created to resolve a problem I had on submitting the project files in CVS repository; the branch has been kept, and it now contains code that is not compatible with the older branches.
    6.x-0.x-dev, and 6.x-1.x-dev will be soon declared unsupported.
  • In the latest commits for the 6.x-1.x-dev version, the site map content is only accessible to the anonymous user; even the admin user cannot access the site map content.

Releases

Official releasesDateSizeLinksStatus
5.x-1.62008-May-2146.69 KBRecommended for 5.xThis is currently the recommended release for 5.x.
Development snapshotsDateSizeLinksStatus
6.x-1.x-dev2009-Mar-0333.21 KBDevelopment snapshotDevelopment snapshots are automatically regenerated and their contents can frequently change, so they are not recommended for production use.
6.x-0.x-dev2008-Nov-1950.94 KBDevelopment snapshotDevelopment snapshots are automatically regenerated and their contents can frequently change, so they are not recommended for production use.
5.x-2.x-dev2009-Feb-1429.22 KBDevelopment snapshotDevelopment snapshots are automatically regenerated and their contents can frequently change, so they are not recommended for production use.


 
 

Drupal is a registered trademark of Dries Buytaert.