merged pull manually

README.md

@@ -11,7 +11,7 @@
 ## Documentation
 
 SilverStripe provides support for the Google Sitemaps XML system, enabling 
-Google and other search engines to see all pages on your site. This helps 
+Google and other search engines to see all urls on your site. This helps 
 your SilverStripe website rank well in search engines, and to encourage the 
 information on your site to be discovered by Google quickly.
 
@@ -20,21 +20,7 @@ be visited: http://yoursite.com/sitemap.xml
 
 See http://en.wikipedia.org/wiki/Sitemaps for info on this format 
 
-In addition, whenever you publish a new or republish an existing page, 
+## Usage Overview
-SilverStripe automatically informs Google of the change, encouraging a Google 
-to take notice. If you install the SilverStripe Google Analytics module, you 
-can see if Google has updated your page as a result.
-
-By default, SilverStripe informs Google that the importance of a page depends 
-on its position of in the sitemap. "Top level" pages are most important, and 
-the deeper a page is nested, the less important it is. (For each level, 
-Importance drops from 1.0, to 0.9, to 0.8, and so on, until 0.1 is reached).
-
-In the CMS, in the "Content/GoogleSitemap" tab, you can set the page importance 
-manually, including requesting to have the page excluded from the google sitemap.
-
-### Setup automatic pinging
-
-	GoogleSitemap::enable_google_notificaton();
 
+See docs/en/* for more information about configuring the module.
 	

_config.php

@@ -5,6 +5,10 @@ Director::addRules(10, array(
 	'sitemap.xml' => 'GoogleSitemap',
 ));
 
-// add the extension 
+// add the extension to pages
-Object::add_extension('SiteTree', 'GoogleSitemapDecorator');
+Object::add_extension('SiteTree', 'GoogleSitemapSiteTreeDecorator');
-?>
+
+// if you need to add this to DataObjects include the following in
+// your own _config:
+
+// GoogleSiteMap::register_dataobject('MyDataObject');

code/GoogleSitemap.php

@@ -10,7 +10,8 @@
  * sitemap whenever the GoogleBot visits your website.
  * 
  * Enabling notification of Google after every publish (in your _config.php):
- * <example
+
+ * <example>
  * GoogleSitemap::enable_google_notificaton();
  * </example>
  * 
@@ -54,16 +55,18 @@ class GoogleSitemap extends Controller {
 	 */
 	public static $google_sitemap_dataobjects_changefreq = array();
 
-
 	/**
-         * Decorates the given DataObject with GoogleSitemapDecorator and pushes
+	 * Decorates the given DataObject with {@link GoogleSitemapDecorator}
-         * the class name to the registered DataObjects.
+	 * and pushes the class name to the registered DataObjects.
 	 * Note that all registered DataObjects need the method AbsoluteLink().
 	 *
 	 * @param string $className name of DataObject to register
+	 * @param string $changeFreq
+	 *
+	 * @return void
 	 */
-        public static function registerDataObject($className, $changeFreq = 'monthly') {
+	public static function register_dataobject($className, $changeFreq = 'monthly') {
-            if (!self::isRegistered($className)) {
+		if (!self::is_registered($className)) {
 			Object::add_extension($className, 'GoogleSitemapDecorator');
 			self::$google_sitemap_dataobjects[] = $className;
 			self::$google_sitemap_dataobjects_changefreq[] = $changeFreq;
@@ -77,7 +80,7 @@ class GoogleSitemap extends Controller {
 	 * 
 	 * @return bool
 	 */
-        public static function isRegistered($className) {
+	public static function is_registered($className) {
 		return in_array($className, self::$google_sitemap_dataobjects);
 	}
 
@@ -87,25 +90,43 @@ class GoogleSitemap extends Controller {
 	 * 
 	 * @param DataObjectSet $newPages 
 	 * 
-         * @return void 
+	 * @return DataObjectSet 
 	 */
-        protected function addRegisteredDataObjects($newPages) {
+	protected function addRegisteredDataObjects() {
-            foreach (self::$google_sitemap_dataobjects as $index => $className) {
+		$output = new DataObjectSet();
+		
+		foreach(self::$google_sitemap_dataobjects as $index => $className) {
 			$dataObjectSet = DataObject::get($className);
-                foreach ($dataObjectSet as $dataObject) {
+			
-                    if ($dataObject->canView() && (!isset($dataObject->Priority) || $dataObject->Priority > 0)) {
+			if($dataObjectSet) {
+				foreach($dataObjectSet as $dataObject) {	
+					if($dataObject->canView() && (!isset($dataObject->Priority) || $dataObject->Priority > 0)) {
 						$dataObject->ChangeFreq = self::$google_sitemap_dataobjects_changefreq[$index];
-                        $newPages->push($dataObject);
+						
+						if(!isset($dataObject->Priority)) {
+							$dataObject->Priority = 1.0;
+						}
+						
+						$output->push($dataObject);
 					}
 				}
 			}
 		}
 		
+		return $output;
+	}
 
+	/**
+	 * Returns all the links to {@link SiteTree} pages and
+	 * {@link DataObject} urls on the page
+	 *
+	 * @return DataObjectSet
+	 */
 	public function Items() {
 		$filter = '';
 
 		$bt = defined('DB::USE_ANSI_SQL') ? "\"" : "`";
+		
 		if(self::$use_show_in_search) {
 			$filter = "{$bt}ShowInSearch{$bt} = 1";
 		}
@@ -113,51 +134,74 @@ class GoogleSitemap extends Controller {
 		$this->Pages = Versioned::get_by_stage('SiteTree', 'Live', $filter);
 
 		$newPages = new DataObjectSet();
+		
 		if($this->Pages) {
 			foreach($this->Pages as $page) {
-				// Only include pages from this host and pages which are not an instance of ErrorPage 
+				// Only include pages from this host and pages which are not an 
-				// We prefix $_SERVER['HTTP_HOST'] with 'http://' so that parse_url to help parse_url identify the host name component; we could use another protocol (like 
+				// instance of ErrorPage. We prefix $_SERVER['HTTP_HOST'] with 
-				// 'ftp://' as the prefix and the code would work the same. 
+				// 'http://' so that parse_url to help parse_url identify the 
-				if(parse_url($page->AbsoluteLink(), PHP_URL_HOST) == parse_url('http://' . $_SERVER['HTTP_HOST'], PHP_URL_HOST) && !($page instanceof ErrorPage)) {
+				// host name component; we could use another protocol (like ftp
+				// as the prefix and the code would work the same. 
+				$pageHttp = parse_url($page->AbsoluteLink(), PHP_URL_HOST);
+				$hostHttp = parse_url('http://' . $_SERVER['HTTP_HOST'], PHP_URL_HOST);
 				
-					// If the page has been set to 0 priority, we set a flag so it won't be included
+				if(($pageHttp == $hostHttp) && !($page instanceof ErrorPage)) {
+
+					// If the page has been set to 0 priority, we set a flag so 
+					// it won't be included
 					if($page->canView() && (!isset($page->Priority) || $page->Priority > 0)) { 
 						// The one field that isn't easy to deal with in the template is
 						// Change frequency, so we set that here.
-						$properties = $page->toMap();
+
+						$date = date('Y-m-d H:i:s');
+						
+						$prop = $page->toMap();
 						$created = new SS_Datetime();
-						$created->value = $properties['Created'];
+						$created->value = (isset($prop['Created'])) ? $prop['Created'] : $date;
+						
 						$now = new SS_Datetime();
-						$now->value = date('Y-m-d H:i:s');
+						$now->value = $date;
-						$versions = $properties['Version'];
+						$versions = (isset($prop['Version'])) ? $prop['Version'] : 1;
+						
 						$timediff = $now->format('U') - $created->format('U');
 
 						// Check how many revisions have been made over the lifetime of the
 						// Page for a rough estimate of it's changing frequency.
-			
 						$period = $timediff / ($versions + 1);
 
-						if($period > 60*60*24*365) { // > 1 year
+						if($period > 60*60*24*365) { 
-							$page->ChangeFreq='yearly';
+							// > 1 year
-						} elseif($period > 60*60*24*30) { // > ~1 month
+							$page->ChangeFreq = 'yearly';
-							$page->ChangeFreq='monthly';
+						} 
-						} elseif($period > 60*60*24*7) { // > 1 week
+						elseif($period > 60*60*24*30) { 
-							$page->ChangeFreq='weekly';
+							$page->ChangeFreq = 'monthly';
-						} elseif($period > 60*60*24) { // > 1 day
+						} 
-							$page->ChangeFreq='daily';
+						elseif($period > 60*60*24*7) { 
-						} elseif($period > 60*60) { // > 1 hour
+							// > 1 week
-							$page->ChangeFreq='hourly';
+							$page->ChangeFreq = 'weekly';
-						} else { // < 1 hour
+						} 
-							$page->ChangeFreq='always';
+						elseif($period > 60*60*24) { 
+							// > 1 day
+							$page->ChangeFreq = 'daily';
+						} 
+						elseif($period > 60*60) { 
+							// > 1 hour
+							$page->ChangeFreq = 'hourly';
+						} else { 
+							// < 1 hour
+							$page->ChangeFreq = 'always';
 						}
 
 						$newPages->push($page);
 					}
 				}
 			}
-                        $this->addRegisteredDataObjects($newPages);
+
-			return $newPages;
 		}
+		
+		$newPages->merge($this->addRegisteredDataObjects());
+		
+		return $newPages;
 	}
 	
 	/**
@@ -178,16 +222,24 @@ class GoogleSitemap extends Controller {
 		if(!GoogleSitemap::$google_notification_enabled || Director::isDev())
 			return;
 			
-		$location = urlencode(Director::absoluteBaseURL() . '/sitemap.xml');
+		$location = urlencode(Controller::join_links(
+			Director::absoluteBaseURL(), 
+			'sitemap.xml'
+		));
 		
-		$response = HTTP::sendRequest("www.google.com", "/webmasters/sitemaps/ping",
+		$response = HTTP::sendRequest(
-			"sitemap=" . $location);
+			"www.google.com", 
+			"/webmasters/sitemaps/ping",
+			sprintf("sitemap=%s", $location)
+		);
 			
 		return $response;
 	}
 	
 	/**
 	 * Enable pings to google.com whenever sitemap changes.
+	 *
+	 * @return void
 	 */
 	public static function enable_google_notification() {
 		self::$google_notification_enabled = true;
@@ -195,11 +247,16 @@ class GoogleSitemap extends Controller {
 	
 	/**
 	 * Disables pings to google when the sitemap changes.
+	 *
+	 * @return void
 	 */
 	public static function disable_google_notification() {
 		self::$google_notification_enabled = false;
 	}
 	
+	/**
+	 * Default controller handler for the sitemap.xml file
+	 */
 	function index($url) {
 		if(self::$enabled) {
 			SSViewer::set_source_file_comments(false);
@@ -212,10 +269,20 @@ class GoogleSitemap extends Controller {
 		}
 	}
 	
+	/**
+	 * Enable the sitemap.xml file
+	 *
+	 * @return void
+	 */
 	public static function enable() {
 		self::$enabled = true;
 	}
 	
+	/**
+	 * Disable the sitemap.xml file
+	 *
+	 * @return void
+	 */
 	public static function disable() {
 		self::$enabled = false;
 	}

code/GoogleSitemapDecorator.php

@@ -6,7 +6,16 @@
  * 
  * @package googlesitemaps
  */
-class GoogleSitemapDecorator extends SiteTreeDecorator {
+class GoogleSitemapDecorator extends DataObjectDecorator {
+
+	
+}
+
+/**
+ * @package googlesitemaps
+ */
+
+class GoogleSitemapSiteTreeDecorator extends SiteTreeDecorator {
 	
 	function extraStatics() {
 		return array(

docs/en/index.md

@@ -0,0 +1,84 @@
+# Google Sitemaps Module
+
+SilverStripe provides support for the Google Sitemaps XML system, enabling 
+Google and other search engines to see all pages on your site. This helps 
+your SilverStripe website rank well in search engines, and to encourage the 
+information on your site to be discovered by Google quickly.
+
+Therefore, all Silverstripe websites contain a special controller which can 
+be visited: http://yoursite.com/sitemap.xml
+
+See http://en.wikipedia.org/wiki/Sitemaps for info on this format 
+
+In addition, whenever you publish a new or republish an existing page, 
+SilverStripe automatically informs Google of the change, encouraging a Google 
+to take notice. If you install the SilverStripe Google Analytics module, you 
+can see if Google has updated your page as a result.
+
+By default, SilverStripe informs Google that the importance of a page depends 
+on its position of in the sitemap. "Top level" pages are most important, and 
+the deeper a page is nested, the less important it is. (For each level, 
+Importance drops from 1.0, to 0.9, to 0.8, and so on, until 0.1 is reached).
+
+In the CMS, in the "Content/GoogleSitemap" tab, you can set the page importance 
+manually, including requesting to have the page excluded from the google sitemap.
+
+
+## Setup automatic pinging
+
+	GoogleSitemap::enable_google_notificaton();
+
+### Include Dataobjects in listing
+
+The module provides support for including DataObject subclasses as pages in
+the SiteTree such as comments, forum posts and other pages which are created
+by DataObjects.
+
+To include a DataObject in the Sitemap it requires that your subclass defines
+two functions.
+
+ * AbsoluteLink() function which returns the URL for this DataObject
+ * canView() function which returns a boolean value.
+
+The SilverStripe convention is to use a Link function to define the AbsoluteLink.
+This enables $Link to work for relative links (while in templates) and $AbsoluteLink
+to work for RSS Feeds and the Sitemap Links.
+
+The following is a barebones example of a DataObject called 'MyDataObject'. It assumes 
+that you have a controller called 'MyController' which has a show method to show the 
+DataObject by it's ID.
+
+	<?php
+	
+	class MyDataObject extends DataObject {
+		
+		function canView() {
+			return true;
+		}
+		
+		function AbsoluteLink() {
+			return Director::absoluteURL($this->Link());
+		}
+		
+		function Link() {
+			return 'MyController/show/'. $this->ID;
+		}
+	}
+
+
+After those methods have been defined on your DataObject you now need to tell 
+googlesitemaps that it should be listed in the sitemap.xml file. Include the 
+following in your _config.php file.
+
+	GoogleSitemap::register_dataobject('MyDataObject');
+
+If you need to change the frequency of the indexing, you can pass the change 
+frequency (daily, weekly, monthly) as a second parameter to register().
+
+So instead of the previous code you would write:
+
+	GoogleSitemap::register('MyDataObject', 'daily');	
+	
+See the following blog post for more information:
+
+http://www.silvercart.org/blog/dataobjects-and-googlesitemaps/