File: /home/httpd/html/freedudetube.com/wp-content/plugins/google-sitemap-generator/documentation.txt
Google XML Sitemaps Generator for WordPress
==============================================================================
This generator will create a sitemaps.org compliant sitemap of your WordPress blog.
Currently homepage, posts, static pages, categories, archives and author pages are supported.
The priority of a post depends on its comments. You can choose the way the priority
is calculated in the options screen.
Feel free to visit my website under www.arnebrachhold.de or contact me at
himself [at] arnebrachhold [dot] de
Have fun!
Arne
Installation:
==============================================================================
1. Upload the full directory into your wp-content/plugins directory
2. Make your blog directory writeable OR create two files called sitemap.xml
and sitemap.xml.gz and make them writeable via CHMOD In most cases, your blog directory is already writeable.
2. Activate it in the Plugin options
3. Edit or publish a post or click on Rebuild Sitemap on the Sitemap Administration Interface
Contributors:
==============================================================================
Basic Idea Michael Nguyen http://www.socialpatterns.com/
SQL Improvements Rodney Shupe http://www.shupe.ca/
Japanse Lang. File Hirosama http://hiromasa.zone.ne.jp/
Spanish lang. File C�sar G�mez Mart�n http://www.cesargomez.org/
Italian lang. File Stefano Aglietti http://wordpress-it.it/
Trad.Chinese File Kirin Lin http://kirin-lin.idv.tw/
Simpl.Chinese File june6 http://www.june6.cn/
Swedish Lang. File Tobias Bergius http://tobiasbergius.se/
Czech Lang. File Peter Kahoun http://kahi.cz
Ping Code Template 1 James http://www.adlards.com/
Ping Code Template 2 John http://www.jonasblog.com/
Bug Report Brad http://h3h.net/
Bug Report Christian Aust http://publicvoidblog.de/
Bug Report Joseph Abboud
Bug Report Mike http://baptiste.us/
Bug Report Peter http://fastagent.de/
Bug Report Glenn http://publicityship.com.au/
Bug Report froosh
File Handling VJTD3 http://www.vjtd3.com/
Code, Documentation, Hosting and all other Stuff:
Arne Brachhold http://www.arnebrachhold.de/
Thanks to all contributors and bug reporters! :)
Release History:
==============================================================================
2005-06-05 1.0 First release
2005-06-05 1.1 Added archive support
2005-06-05 1.2 Added category support
2005-06-05 2.0a Beta: Real Plugin! Static file generation, Admin UI
2005-06-05 2.0 Various fixes, more help, more comments, configurable filename
2005-06-07 2.01 Fixed 2 Bugs: 147 is now _e(strval($i)); instead of _e($i); 344 uses a full < ?php instead of < ?
Thanks to Christian Aust for reporting this :)
2005-06-07 2.1 Correct usage of last modification date for cats and archives (thx to Rodney Shupe (http://www.shupe.ca/))
Added support for .gz generation
Fixed bug which ignored different post/page priorities
Should support now different wordpress/admin directories
2005-06-07 2.11 Fixed bug with hardcoded table table names instead of the $wpd vars
2005-06-07 2.12 Changed SQL Statement of the categories to get it work on MySQL 3
2005-06-08 2.2 Added language file support:
- Japanese Language Files and code modifications by hiromasa (http://hiromasa.zone.ne.jp/)
- German Language File by Arne Brachhold (http://www.arnebrachhold.de)
2005-06-14 2.5 Added support for external pages
Added support for Google Ping
Added the minimum Post Priority option
Added Spanish Language File by C�sar G�mez Mart�n (http://www.cesargomez.org/)
Added Italian Language File by Stefano Aglietti (http://wordpress-it.it/)
Added Traditional Chine Language File by Kirin Lin (http://kirin-lin.idv.tw/)
2005-07-03 2.6 Added support to store the files at a custom location
Changed the home URL to have a slash at the end
Required admin-functions.php so the script will work with external calls, wp-mail for example
Added support for other plugins to add content to the sitemap via add_filter()
2005-07-20 2.7 Fixed wrong date format in additional pages
Added Simplified Chinese Language Files by june6 (http://www.june6.cn/)
Added Swedish Language File by Tobias Bergius (http://tobiasbergius.se/)
2006-01-07 3.0b Added different priority calculation modes and introduced an API to create custom ones
Added support to use the Popularity Contest plugin by Alex King to calculate post priority
Added Button to restore default configuration
Added several links to homepage and support
Added option to exclude password protected posts
Added function to start sitemap creation via GET and a secret key
Posts and pages marked for publish with a date in the future won't be included
Improved compatiblity with other plugins
Improved speed and optimized settings handling
Improved user-interface
Recoded plugin architecture which is now fully OOP
2006-01-07 3.0b1 Changed the way for hook support to be PHP5 and PHP4 compatible
Readded support for tools like w.Bloggar
Fixed "doubled-content" bug with WP2
Added xmlns to enable validation
2006-03-01 3.0b3 More performance
More caching
Better support for Popularity Contest and WP 2.x
2006-11-16 3.0b4 Fixed bug with option SELECTS
Decreased memory usage which should solve timeout and memory problems
Updated namespace to support YAHOO and MSN
2007-01-19 3.0b5 Javascripted page editor
WP 2 Design
YAHOO notification
New status report, removed ugly logfiles
Better Popularity Contest Support
Fixed double backslashes on windows systems
Added option to specify time limit and memory limit
Added option to define a XSLT stylesheet and added a default one
Fixed bug with sub-pages. Thanks to:
- Mike Baptiste (http://baptiste.us),
- Peter Claus Lamprecht (http://fastagent.de)
- Glenn Nicholas (http://publicityship.com.au)
Improved file handling, thanks to VJTD3 (http://www.VJTD3.com)
WP 2.1 improvements
2007-01-23 3.0b6 Use memory_get_peak_usage instead of memory_get_usage if available
Removed the usage of REQUEST_URI since it not correct in all environments
Fixed that sitemap.xml.gz was not compressed
Added compat function "stripos" for PHP4 (Thanks to Joseph Abboud!)
Streamlined some code
2007-05-17 3.0b7 Added option to include the author pages like /author/john
Small enhancements, removed stripos dependency and the added compat function
Added check to not build the sitemap if importing posts
Fixed missing domain parameter for translator name
Fixed WP 2.1 / Pre 2.1 post / pages database changes
Fixed wrong XSLT location (Thanks froosh)
Added Ask.com notification
Removed unused javascript
2007-07-22 3.0b8 Changed category SQL to prevent unused cats from beeing included
Plugin will be loaded on "init" instead of direclty after the file has been loaded.
Added support for robots.txt modification
Switched YAHOO ping API from YAHOO Web Services to the "normal" ping service which doesn't require an app id
Search engines will only be pinged if the sitemap file has changed
2007-09-02 3.0b9 Added tag support for WordPress 2.3
Now using post_date_gmt instead of post_date everywhere
Fixed archive bug with static pages (Thanks to Peter Claus Lamprecht)
Fixed some missing translation domains, thanks to Kirin Lin!
Added Czech translation files for 2.7.1, thanks to Peter Kahoun (http://kahi.cz)
2007-09-04 3.0b10 Added category support for WordPress 2.3
Fixed bug with empty URLs in sitemap
Repaired GET building
Added more info on debug mode
2007-09-23 3.0b11 Changed mysql queries to unbuffered queries
Uses MUCH less memory
Fixed really stupid bug with search engine pings
Option to set how many posts will be included
2007-09-24 3.0 Yeah, 3.0 Final after one and a half year ;)
Removed useless functions
2007-11-03 3.0.1 Using the Snoopy HTTP client for ping requests instead of wp_remote_fopen
Fixed undefined translation strings
Added "safemode" for SQL which doesn't use unbuffered results (old style)
Added option to run the building process in background using wp-cron
Removed unnecessary function_exists, Thanks to user00265
Added links to test the ping if it failed.
2007-11-25 3.0.2 Fixed bug which caused that some settings were not saved correctly
Added option to exclude pages or post by ID
Restored YAHOO ping service with API key since the other one is to unreliable. (see 3.0b8)
2007-11-28 3.0.2.1 Fixed wrong XML Schema Location (Thanks to Emanuele Tessore)
Added Russian Language files by Sergey http://ryvkin.ru
2007-12-30 3.0.3 Added Live Search Ping
Removed some hooks which rebuilt the sitemap with every comment
2008-03-30 3.0.3.1 Added compatibility CSS for WP 2.5
2008-04-28 3.0.3.2 Improved WP 2.5 handling
2008-04-29 3.0.3.3 Fixed author pages
Enhanced background building and increased delay to 15 seconds
Background building is enabled by default
2008-04-28 3.1b1 Reorganized files in builder, loader and UI
Added 2 step loader so only code that's needed will be loaded
Improved WP 2.5 handling
Secured all admin actions with nonces
2008-05-18 3.1b2 Fixed critical bug with the build in background option
Added notification if a build is scheduled
2008-05-19 3.1b3 Cleaned up plugin directory and moved asset files to subfolders
Fixed background building bug in WP 2.1
Removed auto-update plugin link for WP < 2.5
2008-05-22 3.1 Marked as 3.1 stable, updated documentation
2008-05-27 3.1.0.1 Extracted UI JS to external file
Enabled the option to include following pages of multi-page posts
Script tries to raise memory and time limit if active
Maybe Todo:
==============================================================================
- Your wishes :)
License:
==============================================================================
Copyright 2005, 2006, 2007 ARNE BRACHHOLD (email : himself - arnebrachhold - de)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Developer Documentation
==============================================================================
Adding other pages to the sitemap via other plugins
This plugin uses the action system of WordPress to allow other plugins
to add urls to the sitemap. Simply add your function with add_action to
the list and the plugin will execute yours every time the sitemap is build.
Use the static method "GetInstance" to get the generator and AddUrl method
to add your content.
Sample:
function your_pages() {
$generatorObject = &GoogleSitemapGenerator::GetInstance(); //Please note the "&" sign!
if($generatorObject!=null) $generatorObject->AddUrl("http://blog.uri/tags/hello/",time(),"daily",0.5);
}
add_action("sm_buildmap","your_pages");
Parameters:
- The URL to the page
- The last modified data, as a UNIX timestamp (optional)
- The Change Frequency (daily, hourly, weekly and so on) (optional)
- The priority 0.0 to 1.0 (optional)
===============================================
Adding additional PriorityProviders
This plugin uses several classes to calculate the post priority.
You can register your own provider and choose it at the options screen.
Your class has to extend the GoogleSitemapGeneratorPrioProviderBase class
which has a default constructor and a method called GetPostPriority
which you can override.
Look at the GoogleSitemapGeneratorPrioByPopularityContestProvider class
for an example.
To register your provider to the sitemap generator, use the following filter:
add_filter("sm_add_prio_provider","AddMyProvider");
Your function could look like this:
function AddMyProvider($providers) {
array_push($providers,"MyProviderClass");
return $providers;
}
Note that you have to return the modified list!