=== WP SIMILE Timeline === Contributors: freshlabs Tags: api, widget, visualization, javascript, simile, timeline, time, posts, post, ajax, integration, rss, feed Requires at least: 2.3 Tested up to: 2.7 Stable tag: 0.4.2 Integrates the SIMILE Timeline into WordPress and provides an option interface for the various timeline settings. == Description == This plugin integrates the [SIMILE Timeline](http://simile.mit.edu/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 DHTML-based ajaxy widget for visualizing time-based events. 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. Copy or upload the folder `wp-simile-timeline` to the `/wp-content/plugins/`directory 3. Activate the plugin through the WordPress plugins page 4. Include `` or the shortcode `[similetimeline]` in your page or post 5. 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) 6. Enable categories on the Timeline options page = Template Tags = You can either use a PHP template tag or a WordPress shortcode. * `[similetimeline]` Outputs the standard timeline for the categories set in the options panel * `[similetimeline cats="20,38,50" id="my-timeline"]` Outputs the timeline with the DOM-ID "my-timeline" and loads the categories 20, 38 and 50. This usage overrides the settings for active categories from the option panel. Equivalent PHP template tags: * `` * `` == Frequently Asked Questions == = 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/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 == Custom Fields == You may provide an individual icon or image for a post that will show in the timeline. Add a custom field in your write interface using one of these fields: * **timeline_icon** (recommended) * **timeline_image** To define a custom link for the title inside the timeline info bubble you can use the custom field * **timeline_link** To specify your own link per post. == Changelog == **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.39a (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.38a (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.37a (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.36a (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.35a (12/10/2008):** * Fixed broken option page form action **0.34a (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.33a:** * 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.32a:** * 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.31a:** * 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