Timeline Express

• April 4th, 2020 =
• New: Prevent clicking announcement container links in the editor.
• Fix: Fix various block errors.
• Fix: Remove reference to $ in favor of jQuery.
• Tweak: Adjust welcome page styles.
• Tweak: Various fixes for WordPress 5.4 compatibility.

• December 15th, 2018 =
• New: Introduce new Timeline content block (inside of the widget content blocks).
• Tweak: Remove unused jquery masonry script enqueue.

• December 10th, 2018 =
• New: Disable the block editor for announcements.
• New: Introduce new filters for better control over caching.

• November 3rd, 2018 =
• View Changes
• New: Introduce support for new Timeline Express - This Day in History Add-On and Timeline Express - Sliders Add-On.
• New: Introduce timeline_express_transient_name filter to customize the transient name
• New: Introduce JavaScript events during specific points of execution: timelineLayoutStart, timelineLayoutComplete
• Tweak: Adjust CSS styles on certain elements on the timeline.

• September 24th, 2018 =
• New: Introduce a method for toggling on/off the built-in caching. This new toggle is in the sidebar on the Timeline Express settings page.
• New: Introduce timeline_express_disable_cache filter to disable caching.
• New: Add functionality to disable cache when timeline_express_disable_cache is true, or when WP_DEBUG is true.

• September, 2018 =
• Tweak: Add class year-icon to the announcement container when TIMELINE_EXPRESS_YEAR_ICONS is defined and true.
• Tweak: Tweak admin table announcement image thumbnail height.
• Tweak: Resolve PHP warnings on add-ons page.

• August, 2017 =
• New: Introduced qtranslate-x compatibility files. Timeline Express cache is cleared when using qtranslate, to ensure translations load properly.
• Tweak: Remove shorthand array syntax [] to maintain backwards compatibility with PHP < 5.6.

• July, 2017 =
• Tweak: Remove shorthand array syntax [] to maintain backwards compatibility with PHP < 5.6.
• Tweak: Updated regex when generating icons. Props @tkchouaki

• July, 2017 =
• New: Introduced the new menu icon, to unify branding between free/pro/website.
• Tweak: Removed old date field.
• Tweak: Updated jQuery UI to PHP date format conversions.
• Tweak: Refactored get_announcement_image() REST function, causing issues for some.
• Tweak: Updated the 'Announcement Image' field label to 'Announcement Banner'.

• March 22nd, 2017 =
• Shifted the PHP version check to prevent tracking file from loading on PHP versions older than version 5.6.
• Tweaked styles on the add-ons page, introduced 'Popular' & 'Free' badges.
• Added Timeline Express - Popups Add-On to the add-ons page.

• May 14th, 2017 =
• Introduced

  timeline_express_animation_disabled

  filter to disable timeline animations on a per page basis, as needed.
• Introduced

  timeline_express_scroll_to

  filter to disable the jQuery page scroll to when a URL hash is set (eg: http://www.example.com/#announcement-title).
• Enhanced the add-ons page UX, allowing users to install & activate plugins directly from that page, via AJAX.

• April 1st, 2017 =
• Resolved PHP warnings thrown on add-ons page when using a PHP version older than 5.6.0.

• March 14th, 2017 =
• Introduced new hotfix for i10n month names and introduced a new filter timeline_express_i10n_months for adding months that are not yet supported.
• Removed the old user tracking method and introduced our own.
• Refactored two week admin notice.

• February 7th, 2017 =
• When users are using a custom date format, the announcement dates were not saving properly. This is now resolved.
• Tweaked i18n translation strings.
• Refactored the default settings and settings functions.
• Added Toolbox Add-On to the add-ons page.

• January 23rd, 2017 =
• Set year icons to white.
• Alphabetically sort the returned add-ons array.
• Refactor many of the functions contained within.
• Adjusted i18n strings on options page.
• Shifted around the timeline_express_custom_date_format filter so it is referenced in more locations.
• Introduced a new helper to format the jQuery UI picker for international users.
• Update twitter feed add-on image path.
• Tweak add-on page styles.
• Update add-ons page layout and styles.
• Introduced new parameter into timeline_express_get_announcement_icon_markup(), controlling the link wrap around the icon container. (Props @Arifi)
• Check for curl_exec before loading the usage tracking class.

• December 15th, 2016 =
• Adjusted the links on the add-ons page to lead to https://www.wp-timelineexpress.com/add-ons/
• Updated default font awesome version to 4.7.0.
• Introduced timeline_express_announcement_date_text filter to alter the announcement date string (see: http://wp-timelineexpress.com/documentation/alter-announcement-date-string/)
• Built in support for TwentySeventeen theme in the page wrapper templates.
• Adjusted translation functions.

• December 14th, 2016 =
• Tweaks to the styles on the front end (Compatible with Twenty Seventeen)
• Removed duplicate banner in css/js files.
• Altered third parameter of the timeline-express-after-timeline filter, passing in the query object instead of just the number of ->found_posts.

- Tweaks to CSS/JS files.

• November 4th, 2016 =
• Removed jquery-masonry reference from the WordPress timeline plugin.
• Images located at external URLs can now be used, so you can reference images from other sites. (However, the image will not crop to the appropriate dimensions, and will remain at its original size).
• Removed margin on WordPress Timeline containers. Under certain conditions, this caused overlapping on the containers. (If you need to adjust the spacing, please see our help documentation)
• Refactored the style.css file, for readability & conciseness (removed excess declarations etc.).
• Swapped the announcement date HTML wrapper from a <strong> tag to a <p> tag.
• Tweaked styles in the plugin for better 'out of the box' appearance.
• Tweaked settings page, add-ons list.
• Updates to the readme.txt file.

• October 31st, 2016 =
• Added new hooks to the options page.
• Introduced timeline_express_announcement_query filter, to filter the final WP_Query object (including results).
• Introduced timeline_express_announcement_permalink filter, to filter the read more link URL.
• Introduced new helper functions: get_timeline_express_add_ons(), add_timeline_express_add_on, remove_timeline_express_add_on, timeline_express_generate_options_header, timeline_express_generate_options_tabs
• Added new styles for the options page header/tabs.
• Added missing local font awesome icons.
• Define new constant to load font awesome icons ( define( 'TIMELINE_EXPRESS_FONT_AWESOME_LOCAL', true ); - added to theme functions.php will load font awesome icons locally instead of Font Awesome CDN).
• Bumped version numbers.

• October 12th, 2016 =
• Added PHP version check before including our tracking class.
• Fixed undefined orderby variable on the admin list table.
• Moved all advertisement templates into a single template file, and served it via an array.

• i18n focused - October 9th, 2016 =
• Updates to the i18n functions and strings.
• Added full RTL support.
• Style and layout tweaks to welcome page and add-ons page.
• Update to latest stable release of CMB2.
• Rebuilt the welcome and add-ons pages, including styles.
• Re-added and localized the advertisements, to serve them locally.
• Re-factor/update spacing and doc blocks in the code, throughout the plugin (.php & .js files).
• Updated Grunt.js file with new functions.
• Built in RTL support.
• Generated an RTL css file for admin/front end.
• Generated new language files (po/mo).

• October 11th, 2016 =
• Added two week dismissible notice.
• Added optional user tracking class, to help understand plugin usage.
• Updated strings within translation files.
• Tweak a few styles, re-minify styles, update banners.

• September 18th, 2016 =
• Fixed bug where 'years' were not displaying properly when using TIMELINE_EXPRESS_YEAR_ICONS.
• Introduced a new helper function, timeline_express_get_announcement_date_timestamp.
• Double spaced our helpers.php file for easier reading.
• Re-factored a few helper functions.
• Added a new WPML config file (Now 100% compatible with WPML!).

• September 14th, 2016 =
• Minor tweaks to template engine.
• Updated add-ons feed.
• Tweaked the settings styles (inherit WordPress core styles).

• September 12th, 2016 =
• Removed collision detection, causing initialization issues for certain users.
• Introduced new templating engine, to aid in creation of the single-announcement template page wrappers (no longer requires user interaction on most themes).
• Introduced new template files (timeline-express-page-wrappers-start.php, timeline-express-page-wrappers-end.php, timeline-express-sidebar.php)
• Introduced new action hooks inside of single-timeline-express.php ( timeline_express_before_main_content, timeline_express_after_main_content,timeline_express_sidebar)
• Added additional single announcement template styles.
• Tested with bundled WordPress themes (TwentyFourteen-TwentySixteen), and a few other popular themes (Divi, X Theme etc.)

• August 13th, 2016 =
• Prepped for post type add-on (re-factored sections, including template inclusions).
• Altered the date function, switched out the parameter from $announcement_date to $post_id (post ID can be used to retrieve appropriate data from the announcements)
• Set a fall back date (current time) on the announcement container classes when no announcement date is set.
• Added new collision detection between announcement containers.
• Included jquery collision plugin.

• August 12th, 2016 =
• Repaired translation contexts, which were improperly printing in unwanted locations. (Admin Menus)

• July 4th, 2016 =
• Repair initial options on plugin activation (some options not stored/referenced properly).
• Re-enable the 'Add-ons' menu item.

• June 6th, 2016 =
• Re-added parameters removed from the announcement custom post type.
• Fixed strange re-direct when viewing an announcement on the front-end, with 'Exclude Announcements from Site Searches' set to true.

• June 3rd, 2016 =
• Bump version.
• Fix AJAX media library grid breaking.
• Fix announcements appear in site search setting.
• Remove un-used, old content filter function.

• June 3rd, 2016 =
• Quick patch to completely remove any RSS feed dependency (which was not well thought out to begin with).
• Added missing class to the announcement image on single templates.

• May 24th, 2016 =
• Bumped version numbers.
• Fixed uninstall file throwing errors.
• Set all containers to 100% (fixes width issue when announcements contain no content)
• Removed 100% width from the featured image on single announcements. (now width: auto)
• Built in support for srcset attribute on single announcement pages (to reset images to 100% on single pages use the following CSS body.single-te_announcements .announcement-banner-image { width: 100% })
• Timeline now flips to 95% width when the browser is set to 822px and below.
• Built in suppot for j F Y date formats.

• May 18th, 2106 =
• Define a custom content filter, to enable shortcode usage and other quirks in announcements. (Note:YouTube embeds need to be done with the `[embed]www.youtube_url.com[/embed] shortcode.)
• New single announcement template can be fully customized. Please see: How do I customize the single announcement template?.

• May 17th, 2106 =
• Revert to the old method of filtering the content. (this was an overlooked breaking change)
• Fix content filtering issue - some themes not properly displaying the content on single announcements.
• Refactor.

• May 16th, 2106 =
• Cleared old conditional which didn't work on some themes due to priority. Single announcements are now loaded via a custom template (single.timeline-express.php - which can be overridden by copying to theme root into a 'timeline-express' direcotry).
• Single announcement pages may not work with ALL themes, and might need to be customized (we've done our best).
• Added new helper function to load the single announcement template class.
• Re-minify css/js
• Tweak front end single announcement template styles.
• Added new conditional, dynamic sidebar for single announcement templates.

• May 13th, 2106 =
• Added a new conditional to load the proper template. (Fixed wrong template loaded when displaying the timeline inside a post)
• Repaired the bootstrap selector - any missing icons should now be present.

• May 10th, 2016 =
• Re-added the 'Read more' button to all announcements, regardless of length
• Removed the 'Read More' text/link after the ellipses
• Fixed theme overriding timeline excerpt lengths, added priority 999 and a post_type() conditional
• Fixed weird admin responsive issue due to hard coded widths on the columns
• Localized the date picker to honor the date format setting inside of 'Settings > General > Date Format'
• Fixed the 'Read More' toggle setting not properly removing the links from the icons

• May 9th, 2016 =
• Repair timeline_express_frontend_excerpt filter.
• Used wp_kses_post() instead of esc_attr() when printing the excerpts.

• May 8th, 2016 =
• Refactored plugin base to improve stability - split code base into classes and re-wrote many functions.
• Plugin now more extendable, and much easier to style and customize.
• New templating system in place, to allow for users to override, for help please see our customization articles.
• Plugin WordPress compatible, following all standards.
• Transients setup for front end caching (page transient caching to allow for different timelines on different pages).
• Flush re-write rules now properly setup, to flush when needed (saving a page with the shortcode on it, saving the settings, creating/updating an announcement).
• Started writing unit tests for improved future proofing.
• Tweaked front end styles a bit, to improve consistency between themes.
• Documentation site being built out, to help with questions. (http://www.wp-timelineexpress.com/documentation/)
• Added additional filters and hooks to help with customizations.
• Wrapped every string in the plugin in the appropriate gettext filters.
• Added new options to disable animations and prevent scroll/fade in animations.
• Tested migration from 1.1.8.2 to 1.2 - including new options.
• Added new optional shortcode parameters limit (integer, limiting the number of announcements to display), display ('Future', 'Past' or 'All' to set which announcements will display on the timeline) and sort ('DESC' or 'ASC' to set the order of the timeline).
• Frontend inline styles are now more reliable in overriding the appropriate elements.

• March 16th, 2016 =
• Included the latest release of CMB2 to help combat conflicts with other plugins.

• Februrary 22nd, 2016 =
• Built in filters/support for AJAX Limit add-on.

• Februrary 12th, 2016 =
• Fixed reversed is_ssl() checks.

• Februrary 10th, 2016 =
• Ensured that the minified version of font awesome is enqueued on the front end (v4.5.0)
• Ensured that the correct version (and fallback) of font awesome was used on both frontend and backend.
• Added RTL support.

• February 7th, 2016 =
• New hooks for add-ons implemented: timeline_express_sanitize_date_format, timeline_express_admin_render_date_format, timeline_express_admin_column_date_format, timeline_express_frontend_query_args, timeline_express_frontend_date_filter
• Fix background line color options not properly updating.

• February 5th, 2016 =
• Upgraded font awesome library from 4.3.0 to 4.5.0.
• Added a fallback for the font awesome library - when the CDN is not accessible for whatever reason.
• Added CDN responses to transient to decrease page load times.
• Included a new filter allowing users to specify a font awesome version number to load from the CDN (timeline_express_font_awesome_version - see other notes.).

• January 30th, 2016 =
• Wrapped single announcement template date in timeline_express_custom_date_format filter to allow users to alter that, as well as the date in the timeline.

• October 2nd, 2015 =
• Fixed issue with timeline icons not saving properly, and returning empty on the front end.

• September 28th, 2015 =
• Fixed incorrect name for default icon dropdown.

• September 18th, 2015 =
• Fixed adding custom fields and using an image as an icon (https://gist.github.com/EvanHerman/6bbc8de82f34b4cb3c5c#comments)

• July 15th, 2015 =
• Remove duplicate date picker fields on announcements

• July 14th, 2015 =
• Repair date picker field not being initialized properly

• July 11th, 2015 =
• Update to CMB2
• Fix default settings on fresh install
• Removed max length on the announcement excerpts
• Altered query to query comparison to reflect current date, not date+time (announcements save dates, not date+time)

• July 10th, 2015 =
• Included hungarian translation - props Zsolt

• June 22nd, 2015 =
• Remove !important declarations on frontend
• Adjusted announcement images to be 100% width
• Included hungarian translation - props Zsolt

• May 5th, 2015 =
• Fixed incorrect version of font awesome enqueued on front end

• May 4th, 2015 =
• Added new filter to allow for custom images to be used in place of font awesome icons (Props Pete Nelson)
• Added

• April 1st, 2015 =
• Enhancement: reverted to older styles (v1.1.6.4 stylesheet)

• March 31st, 2015 =
• Enhancement: re-wrote part of the CSS file, to allow for native masonry layouts (uniform spacing between containers)

• March 23rd, 2015 =
• Enhancement: Packaged French translation - thanks goes to Julien Lambert
• Enhancement: Fixed a few typos in the plugin

• March 22nd, 2015 =
• Enhancement: Added wp_error class to catch errors thrown by wp_remote_get() when building the bootstrap dropdown.

• March 18th, 2015 =
• Enhancement: Removed add_option(); call which was breaking previously stored options on activation

• March 10th, 2015 =
• Enhancement: Altered new option label to be 'Exclude Announcements from Site Searches' (settings were reversed (true excluded while false included) )

• March 9th, 2015 =
• Enhancement: Fixed 404 issue on announcement posts when 'Include Announcement in Site Searches' was set to 'false'.

• March 6th, 2015 =
• Enhancement: Added a priority to the metabox initialization, which caused conflicts with other plugins using the same class

• March 5th, 2015 =
• Enhancement: Upgraded font-awesome to 4.3.0
• Enhancement: Added icon select dropdown on the settings page, to better mirror the post/page edit screens
• Enhancement: Added new setting to toggle Timeline posts from appearing in search queries on the front end (defaults to true)
• Enhancement: Packaged German translation - thanks to Martin Gerlach

• February 5th, 2015 =
• Enhancement: Added a dropdown to select the font awesome icon
• Enhancement: Fadded in the timeline after everything has initialized, to prevent seeing a messed up Timeline layout

• February 5th, 2015 =
• Fixed: Issue with the excerpt being truncated and throwing off entire timeline layout (issue occured when truncate happened mid html tag , which left a tag open)
• Fixed: Wrapped missing text in text domain

• February 1st, 2015 =
• Fixed: Wrapped admin column headers in get text filter
• Fixed: Sort orders by announcement date
• Enhancement: Added filter to define custom image size for announcement image

• January 19th, 2015 = Fixed: Remove unnecessary filter in the main class file

• January 16th, 2015 = Fixed: Fixed incorrect date save format

• January 13th, 2015 = Fixed: Errors thrown from new user fields hook, when no custom fields are defined by the user Fixed: Incorrect date format for new announcements

• January 10th, 2015 = Fixed: Data saving incorrectly to the database, causing errors to be thrown on front and back end

• January 10th, 2015 = Enhancement: Added new filter ( timeline_express_custom_fields ) which allows users to define their own custom fields to use on Timeline Announcement posts (see readme for example). Fixed: CMB class file causing conflicts with other plugins, and removed the old version Fixed: Adjusted a few styles on the announcement post page

• January 2nd, 2015 =
• Fixed: Issue with date storing different on backend vs front end
• Fixed: Settings link on the Timeline Express welcome page

• December 24th, 2014 =
• Enhancement: Implemented premium support licensing. Any issues that require immediate response, or custom code should purchase a support license.
• Enhancement: Added a new filter to customize the announcement slug (possibly for SEO purposes) (timeline-express-slug , check documentation for examples)
• Enhancement: Moved settings/support below Timeline Express parent menu item
• Fixed: Errors thrown when announcement images aren't set
• Fixed: Display error where announcements displayed a different date on the backend vs frontend

• December 11th, 2014 =
• Enhancement: Added Dutch language translation (nl_NL) - thanks goes to Kees Hessels
• Fixed: A few typos throughout the plugin

• December 10th, 2014 =
• Enhancement: Added new filter timeline-express-read-more-class which allows users to add custom classes to the 'Read More' button
• Enhancement: Wrapped 'Read More' in gettext filter, to allow for text to be altered

• December 6th, 2014 =
• Fixed: Weird query issue with timeline announcements not displaying at proper times
• Fixed: Styling issue with announcement date picker calendar arrow
• Fixed: Removed all line-breaks and hyphens from the timeline titles

• December 5th, 2014 =
• Fixed: Minor styling issues with announcement images extending outside the announcement container (added new class to the image .announcement-banner-image)

• December 4th, 2014 =
• Fixed: Minor styling issues with the mobile timeline icon size/margins
• Fixed: Minor styling issues with the mobile timeline announcement arrow appearing 1px to soon
• Fixed: Typo of 'Timeline Express' in the admin settings menu

• December 3rd, 2014 =
• Fixed: Fixed styles when timeline is inside posts (fixed icon size, duplicate images)
• Fixed: Fixed a few enqueue functions
• Enhancement: Polish language translation now included (pl_PL) - thanks goes to Kanios
• Enhancement: Enqueued new styles on single announcement posts to style the announcement pages a bit better
• Enhancement: Added new custom image size, to unify announcement images on the timeline ('timeline-express')
• Enhancement: Added new function timeline_express_get_image_id() to get attachment image IDs by URL
• Enhancement: Stripped out a lot of un-needed code

• November 19th, 2014 =
• Updated: Localized date format displayed on the front end as requested by our international users ( format now takes on what you have in 'General > Settings' )
• Updated: Fixed styling issue on date picker arrows
• Feature: Added new filter to allow users to specify a custom date format (timeline_express_custom_date_format)

• November 17th, 2014 =
• Updated: Single announcement template file, which was causing issues for some users on specific themes
• Feature: Added a new filter to allow users to load custom template files
• Feature: Added auto update feature for Timeline Express
• Fixed: Issue where links in the excerpt and 'read more' links couldn't be clicked due to overlapping masonry elements
• Fixed: Missing image on welcome page
• Fixed: Minor issues on welcome page including some links

• November 13th, 2014 =
• Enhancement: Portuguese language translation now included (pt_BR) - thanks goes to Gustavo Magalhes

• Fixed fatal error thrown on activation for sites running older versions of PHP

• Change priority argument on register post type function, which caused conflicts with other custom post types on certain sites

• Chinese language translation now included (zh_CN) - thanks goes to Vahi Chen
• Removed some un-necessary styles (timeline title/content font-size+font-family declerations)

• Included new function to retain formatting in the announcement excerpt in the timeline (te_wp_trim_words_retain_formatting())

• Add a display order setting to set Ascending or Descending display order for announcements in the timeline
• Fixed "cannot access settings page" when clicking on the settings tab when on the settings page already

• Update masonry function to include .imagesLoaded(); to prevent overlapping containers in the timeline