=== WP SIMILE Timeline === Contributors: freshlabs Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4266902 Tags: api, widget, visualization, javascript, simile, timeline, time, posts, post, ajax, integration, rss, feed, links Requires at least: 2.6. Tested up to: 2.8.4 Stable tag: 0.4.6 Integrates the SIMILE Timeline into WordPress and provides an option interface for the various timeline settings. == Description == This plugin integrates the [SIMILE Timeline](http://www.simile-widgets.org/timeline/ "SIMILE Timeline at SIMILE Labs") into WordPress and provides an option interface for the various timeline settings. Developed by SIMILE Labs, the Timeline is a web widget for visualizing temporal data. Features: * Include individual categories to be display in the timeline * Build a lifestream timeline with RSS feeds from your WordPress link archive * Customize colors for timeline bands and categories * Supports multiple instances on different pages by using a template tag * Display individual icons or images with custom fields == Installation == 1. Unpack the ZIP-archive 2. Delete or deactivate any previous versions of this plugin. 3. Copy or upload the folder `wp-simile-timeline` to the `/wp-content/plugins/`directory 4. Activate the plugin through the WordPress plugins page 5. Include `` or the shortcode `[similetimeline]` in your page or post 6. Specify the page ID of the page where you included the Timeline on the Options > SIMILE Timeline page This will output the necessary JavaScript and CSS in the HTML head (Set this value to 0 to include the Timeline script on all pages) 7. Enable categories on the Timeline options page = Documentation = You can either use a PHP template tag or WordPress shortcode. * `[similetimeline]` * `` For your convenience there is a documentation section within the plugin's option page. == Frequently Asked Questions == = General problem solving = * If you encounter JavaScript alert dialogs/popups, the timeline has initialization or parsing problems. These error messages are triggered inside the SIMILE API and cannot be controlled by the plugin author. For support in this direction I recommend the [SIMILE Google Group](http://groups.google.com/group/simile-widgets/) and the [SIMILE Wiki](http://code.google.com/p/simile-widgets/wiki/Timeline). * Most basic problems have been discussed and mostly fixed in the [blog comments](http://www.freshlabs.de/journal/archives/2006/10/wordpress-plugin-simile-timeline/#comments). * [http://groups.google.com/group/wp-simile-timeline](http://groups.google.com/group/wp-simile-timeline) is the official discussion group of this plugin which replaces the blog comment support since 21-03-2009. = The timeline does not show up in my page or post = * Make sure you have the shortcode `[similetimeline]` included or `` set up in your page or post. * Make sure the page-ID setting for the timeline is either 0 (zero) or an individual post ID. This option sets whether the neccessary JavaScript is loaded in the <head> section of your HTML. * Try to clean your browser cache and then refresh the timeline page. Since the widget uses loads of JavaScript, changed settings often take a while until they replace the cached version. = The timeline does not show any posts = * The content for the timeline is retrieved inside the XML file `/wp-content/plugins/wp-simile-timeline/data/timeline.xml.php`. Try to call that file directly to see if posts show up there. * When the XML file shows posts and seems valid, try to clean your browser cache and refresh the timeline page. * Make sure you have checked at least one category to be timelined on the settings page and that there are public posts in that category. = There are no titles showing in the timeline = * Please check if you have marked the checkbox *Show labels* for the desired band. * Try to clean your browser cache and then refresh the timeline page. Since the widget uses loads of JavaScript, changed settings often take a while until they replace the cached version. == Screenshots == 1. Settings Page 2. Timeline Widget == Changelog == **0.4.6 (08/09/2009):** * WordPress 2.8.4 compatibility * Markup and stability fixes on option pages. Fixes Setting-get-erased-bug (thanks to Shane and Erin) * Fixed Jump to link location-bug (thanks to rudevich) * JavaScript fixes on option pages (jQuery tabs) **0.4.5.4 (02/04/2009):** * Fixed collision with JavaScript (jQuery UI Tabs) when inserting media in posts. **0.4.5.3 (22/03/2009):** * Fixed: Database-options were initialized with empty values **0.4.5.2 (21/03/2009):** * IMPORTANT: The plugin drops compatibility with WP 2.3 due to the usage of WP 2.5 specific post interface methods as well as jQuery UI tabs. * IMPORTANT: The custom field options `timeline_icon`, `timeline_image` and `timeline_link` were renamed! See the online-documentation for new syntax! * Implemented new date options for imprecise events (latestStart and earliestEnd) in post panel * Tab-enhanced admin interface using WordPress built-in jQuery UI Tabs (renders plugin only compatible with WP 2.5+) * Implemented uninstall method to remove plugin-related database entries (also helpful for troubleshooting) * Removed redundant color settings in JavaScript files (all done with CSS now) * Fixed: Only active categories with at least one post were listed on the options page * Fixed: IE JavaScript error in onload.js ('Event' is undefined) by simply removing that statement **0.4.5.1 (11/03/2009):** * Updated SIMILE API URL to new location * Generic fixes for changes in the new SIMILE API * Timeline-themes are handled completely via CSS (An integrated dynamic theme processes the option settings). * Updated Italian locale files (thanks to Gianni Diurno) * Fixed directory names in FAQ **0.4.5 (01/03/2009):** * Implemented new shortcode and function parameter `scriptfile` to load custom JS init file from the data folder. * Added reset option for start and end date option in post interface. * Simplified JavaScript initialization (thanks to Pete Myers). * Added new option for the timeline start focus. * Added new option to change click event for timeline entries. **0.4.4 (14/01/2009):** * Included [ADOdb Date Time Library](http://phplens.com/phpeverywhere/adodb_date_library) to make dates before 1970 possible (replaced `mysql2date()` with `adodb_date2()`). * Added version check on option-page entry to prevent update and initialisation problems **0.4.3 (07/01/2009):** * New post option to define event start date (in addition to the end date) to visualize durations * Fixed date formatting in XML file (thanks to Ben ter Stal) * Fixed IE XML parsing errors **0.4.2 (04/01/2009):** * Extended shortcode and template functions with optional parameters for categories * Removed duplicate closing brace in timeline.xml * Fixed link to options page inside plugin description **0.4.1 (30/12/2008):** * Fixed whitespace error in XML data when using `timeline_icon` or `timeline_image` **0.4.0 (02/11/2008):** * Fixed PHP error on plugin activation. * Included Italian locale files (contributed by Gianni Diurno) **0.3.9a (20/10/2008):** * Link categories can also be selected for the timeline: If a link holds an RSS-link, the specific feed is parsed and read into the timeline. Specify a link image to style your feed entries in the timeline (e.g a favicon of the feed service). * Refactored acquisition of categories with WP core functions (taxonomy.php) **0.3.8a (17/10/2008):** * Fixed blank admin menu page on some installations. Now uses the correct API hook `admin_menu`. * Fixed inital installation of database table for MySQL4 and default configuration options. **0.3.7a (15/10/2008):** * Added optional custom field *timeline_link* to define a custom link for the title inside the timeline bubble. * Set showposts to maximum. All entries from the selected categories are shown. * Fixed XML output of the content using WordPress core sanitization functions from `wp-includes/formatting`. Styled content is possible now. * Introduced localized option page for en_US and de_DE. Contributors are welcome! **0.3.6a (14/10/2008):** * Added options for timeline resolution (year, month, week, day, hour) and its interval width in pixels. This replaces the vague resolution selection from previous versions and allows better customisation. * Fixed markup and CSS for end date in the post write panel. **0.3.5a (12/10/2008):** * Fixed broken option page form action **0.3.4a (11/10/2008)** * Fixed add_option_page file parameter. Got invalid link options page on some installations * Fixed register_activation_hook for installing Timeline category table * Fixed plugin folder references due to new foldername by WP plugin directory * Replaced key-comment with shortcode [similetimeline] **0.3.3a:** * WP 2.6 compatibility * Added date string to javascript file call to prevent caching issues * Updated backend GUI with new WordPress CSS classes * Fixed the loop in the xml file. The content now shows up in the info bubbles. * Added Ootion to display future posts **0.3.2a:** * WP 2.3 compatibility. post2cat queries replaced with inner joins on the taxonomy tables (see http://wordpress.org/support/topic/137793) * Added database table stl_timeline_terms for category options to database (outsourcing from core tables) **0.3.1a:** * Fixed option "Show Labels" - nothing was saved because of a typo in the name attribute **0.3a:** * Colors can be defined for categories and the Timeline design * Future Posts that are published will be displayed by the timeline * Loading notification for larger timelines now works * WordPress MU compatibility * Introduced CSS file to style timeline size, border and info bubbles **0.2a:** * Posts can now have an end-date to visualize durations * Titles are linked to full entries * Multiple categories can be "timelined" **0.1a:** * (17/10/2006) r69: The Timeline JavaScript is now loaded only on the page where a timeline is found. This reduces server load at the Simile labs ;) * (16/10/2006) r66: Fixed a JavaScript error on pages where no timeline is included. The script now degrades gracefully. * (15/10/2006) r60: Initial release