=== WP SIMILE Timeline === Contributors: freshlabs Tags: api, widget, visualization, javascript, simile, timeline, time, posts, post, ajax, integration Requires at least: 2.3 Tested up to: 2.6.2 Stable tag: 0.38a 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 * 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 == 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. = 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. == 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** * **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.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