Introduction

When creating an addon, you first want to decide what minimum version of c5 will be required to run your addon. If your answer is something like "I am on the last bleeding cutting edge of c5," then you just don't need this howto.

Now, if you are concerned by offering this addon to the most people, then let's go on a version tour.

Version Differences

Version Numbering

First of all, you might want to understand how Concrete5 numbers its versions by reading the Version Numbering Guide. After reading that you understand that we will only consider the Generational and Primary version number (that is X an Y in 5.X.Y.Z), since the Maintenance Update Version is only here for well … maintenance reasons and will not bring or delete any feature c5 you might need.

We will limit the matrix to versions currently available in the download section of Concrete5.org. I may update this howto from time to time to add missing features.

The following is based on the release notes from http://www.concrete5.org/private/updates/version_history

Events

Events 5.0.0 5.1.1 5.2.1 5.3.1 5.3.2 5.3.3 5.4.0 5.4.1 5.4.2 5.5.0 5.5.1 5.5.2 5.6.0 5.6.1 on_page_view KO KO OK OK OK OK OK OK OK OK OK OK OK OK on_before_render KO KO OK OK OK OK OK OK OK OK OK OK OK OK on_render_complete KO KO OK OK OK OK OK OK OK OK OK OK OK OK on_user_change_password KO KO OK OK OK OK OK OK OK OK OK OK OK OK on_user_update KO KO OK OK OK OK OK OK OK OK OK OK OK OK package level on_start() call KO KO OK OK OK OK OK OK OK OK OK OK OK OK on_group_update KO KO KO KO KO KO KO KO OK OK OK OK OK OK on_group_add KO KO KO KO KO KO KO KO OK OK OK OK OK OK on_page_get_icon KO KO KO KO KO KO KO KO OK OK OK OK OK OK on_page_output KO KO KO KO KO KO KO KO OK OK OK OK OK OK on_user_validate KO KO KO KO KO KO KO KO KO OK OK OK OK OK on_user_logout KO KO KO KO KO KO KO KO KO OK OK OK OK OK on_user_activate KO KO KO KO KO KO KO KO KO OK OK OK OK OK on_user_deactivate KO KO KO KO KO KO KO KO KO OK OK OK OK OK on_before_job_execute KO KO KO KO KO KO KO KO KO OK OK OK OK OK on_job_execute KO KO KO KO KO KO KO KO KO OK OK OK OK OK on_job_install KO KO KO KO KO KO KO KO KO OK OK OK OK OK on_job_uninstall KO KO KO KO KO KO KO KO KO OK OK OK OK OK on_composer_publish KO KO KO KO KO KO KO KO KO KO KO KO OK OK on_composer_save_draft KO KO KO KO KO KO KO KO KO KO KO KO OK OK on_composer_delete_draft KO KO KO KO KO KO KO KO KO KO KO KO OK OK on_block_load KO KO KO KO KO KO KO KO KO KO KO KO OK OK closure support for events (require PHP 5.3+) KO KO KO KO KO KO KO KO KO KO KO KO OK OK on_file_added_to_set KO KO KO KO KO KO KO KO KO KO KO KO KO OK on_get_countries_list KO KO KO KO KO KO KO KO KO KO KO KO KO OK on_get_states_provinces_list KO KO KO KO KO KO KO KO KO KO KO KO KO OK on_file_removed_from_set KO KO KO KO KO KO KO KO KO KO KO KO KO OK on_page_urlify KO KO KO KO KO KO KO KO KO KO KO KO KO OK on_page_body_index KO KO KO KO KO KO KO KO KO KO KO KO KO OK

3rd libraries shipped

3rd Party Libs 5.0.0 5.1.1 5.2.1 5.3.1 5.3.2 5.3.3 5.4.0 5.4.1 5.4.2 5.5.0 5.5.1 5.5.2 5.6.0 5.6.1 ADODB 5.02 OK OK OK OK OK OK OK OK OK OK OK OK OK OK jQuery 1.2.6 OK OK OK OK OK OK OK OK OK OK OK OK OK OK jQueryUI 1.5.2 OK OK OK OK OK OK OK OK OK OK OK OK OK OK TinyMCE 3.0.9 OK OK OK OK OK OK OK OK OK OK OK OK OK OK ADODB 5.07 KO KO KO OK OK OK OK OK OK OK OK OK OK OK jQuery 1.3.2 KO KO KO OK OK OK OK OK OK OK OK OK OK OK jQueryUI 1.7.1 KO KO KO OK OK OK OK OK OK OK OK OK OK OK TinyMCE 3.2.2.3 KO KO KO OK OK OK OK OK OK OK OK OK OK OK Secureimage 1.0.3.1 KO KO KO OK OK OK OK OK OK OK OK OK OK OK ADODB 5.10 KO KO KO KO KO KO OK OK OK OK OK OK OK OK jQuery 1.4 KO KO KO KO KO KO OK OK OK OK OK OK OK OK TinyMCE 3.3 KO KO KO KO KO KO OK OK OK OK OK OK OK OK TinyMCE 3.3.9.2 KO KO KO KO KO KO KO OK OK OK OK OK OK OK jQuery 1.4.2 KO KO KO KO KO KO KO OK OK OK OK OK OK OK jQueryUI 1.8.4 KO KO KO KO KO KO KO OK OK OK OK OK OK OK TinyMCE 3.3.9.3 KO KO KO KO KO KO KO KO OK OK OK OK OK OK jQuery 1.6.2 KO KO KO KO KO KO KO KO OK OK OK OK OK OK jQueryUI 1.8.14 KO KO KO KO KO KO KO KO OK OK OK OK OK OK jQuery Forms 2.82 KO KO KO KO KO KO KO KO OK OK OK OK OK OK Secureimage 2.0.1beta KO KO KO KO KO KO KO KO OK OK OK OK OK OK TinyMCE 3.4.6 KO KO KO KO KO KO KO KO KO OK OK OK OK OK jQuery 1.7 KO KO KO KO KO KO KO KO KO OK OK OK OK OK jQuery 1.7.1 KO KO KO KO KO KO KO KO KO KO OK OK OK OK JQueryUI 1.8.16 KO KO KO KO KO KO KO KO KO KO OK OK OK OK Zend::Currency KO KO KO KO KO KO KO KO KO KO OK OK OK OK Bootstrap 2 KO KO KO KO KO KO KO KO KO KO KO KO OK OK SimplePie 1.3.1 KO KO KO KO KO KO KO KO KO KO KO KO KO OK

that can be summarized as :

3rd Party Libs 5.0.0 5.1.1 5.2.1 5.3.1 5.3.2 5.3.3 5.4.0 5.4.1 5.4.2 5.5.0 5.5.1 5.5.2 5.6.0 5.6.1 ADODB 5.02 5.07 5.10 jQuery 1.2.6 1.3.2 1.4 1.4.2 1.6.2 1.7 1.7.1 jQueryUI 1.5.2 1.7.1 1.8.4 1.8.14 1.8.16 TinyMCE 3.0.9 3.2.2.3 3.3 3.3.9.2 3.3.9.3 3.4.6 Secureimage KO KO KO 1.0.3.1 2.0.1b jQuery Forms 2.82 Zend::Currency KO KO KO KO KO KO KO KO KO KO OK OK OK OK Bootstrap 2 2 SimplePie 1.3.1

Helpers :

Helpers 5.0.0 5.1.1 5.2.1 5.3.1 5.3.2 5.3.3 5.4.0 5.4.1 5.4.2 5.5.0 5.5.1 5.5.2 5.6.0 5.6.1 JsON KO OK OK OK OK OK OK OK OK OK OK OK OK OK Captcha KO KO OK OK OK OK OK OK OK OK OK OK OK OK Marketplace KO KO OK OK OK OK OK OK OK OK OK OK OK OK Rating Attribute KO KO KO OK OK OK OK OK OK OK OK OK OK OK Page Selector KO KO KO OK OK OK OK OK OK OK OK OK OK OK form/color KO KO KO KO KO OK OK OK OK OK OK OK OK OK form/user_selector KO KO KO KO KO OK OK OK OK OK OK OK OK OK html/v2 KO KO KO KO KO KO OK OK OK OK OK OK OK OK Interface KO KO KO KO KO KO KO OK OK OK OK OK OK OK image helper crop ability KO KO KO KO KO KO KO KO OK OK OK OK OK OK security KO KO KO KO KO KO KO KO KO KO KO KO KO OK ajax KO KO KO KO KO KO KO KO KO KO KO KO KO OK

Features

Feature 5.0.0 5.1.1 5.2.1 5.3.1 5.3.2 5.3.3 5.4.0 5.4.1 5.4.2 5.5.0 5.5.1 5.5.2 5.6.0 5.6.1 Localization KO OK OK OK OK OK OK OK OK OK OK OK OK OK TinyMCE Fixes KO OK OK OK OK OK OK OK OK OK OK OK OK OK User/Group Deletion KO OK OK OK OK OK OK OK OK OK OK OK OK OK Cheap Hosting support KO OK OK OK OK OK OK OK OK OK OK OK OK OK GoDaddy fixes KO OK OK OK OK OK OK OK OK OK OK OK OK OK Events Support KO OK OK OK OK OK OK OK OK OK OK OK OK OK Area Block Limit KO OK OK OK OK OK OK OK OK OK OK OK OK OK Custom thumbnails size KO OK OK OK OK OK OK OK OK OK OK OK OK OK Guestbook Captcha KO KO OK OK OK OK OK OK OK OK OK OK OK OK PageType deletion KO KO OK OK OK OK OK OK OK OK OK OK OK OK PageList/ItemList framework KO KO OK OK OK OK OK OK OK OK OK OK OK OK Customizable Themes KO KO OK OK OK OK OK OK OK OK OK OK OK OK Marketplace Intergration KO KO OK OK OK OK OK OK OK OK OK OK OK OK Global Tracking Code KO KO OK OK OK OK OK OK OK OK OK OK OK OK "Featured" page in PageList KO KO OK OK OK OK OK OK OK OK OK OK OK OK Signin as other users KO KO OK OK OK OK OK OK OK OK OK OK OK OK Dashboard subpages in nav KO KO OK OK OK OK OK OK OK OK OK OK OK OK dialog "element" syntax support KO KO OK OK OK OK OK OK OK OK OK OK OK OK c5 consolidated custom logs KO KO OK OK OK OK OK OK OK OK OK OK OK OK New c5 interface KO KO KO OK OK OK OK OK OK OK OK OK OK OK Integration with PicNik.com editor KO KO KO OK OK OK OK OK OK OK OK OK OK OK File Versionning KO KO KO OK OK OK OK OK OK OK OK OK OK OK File Sets KO KO KO OK OK OK OK OK OK OK OK OK OK OK Star Files KO KO KO OK OK OK OK OK OK OK OK OK OK OK Files Metadata KO KO KO OK OK OK OK OK OK OK OK OK OK OK Alternate File Storage Location KO KO KO OK OK OK OK OK OK OK OK OK OK OK File API KO KO KO OK OK OK OK OK OK OK OK OK OK OK c5 help system KO KO KO OK OK OK OK OK OK OK OK OK OK OK ScrapBooks KO KO KO OK OK OK OK OK OK KO KO KO KO KO OpenID KO KO KO OK OK OK OK OK OK OK OK OK OK OK IP Banlist KO KO KO OK OK OK OK OK OK OK OK OK OK OK PageList pagination KO KO KO OK OK OK OK OK OK OK OK OK OK OK C5 indexing framework (MySQL fulltext search) KO KO KO OK OK OK OK OK OK OK OK OK OK OK Automatic Block CSS and JS loading KO KO KO OK OK OK OK OK OK OK OK OK OK OK page_not_found support KO KO KO OK OK OK OK OK OK OK OK OK OK OK custom templates for global blocks KO KO KO OK OK OK OK OK OK OK OK OK OK OK Block Types always removable KO KO KO OK OK OK OK OK OK OK OK OK OK OK Logs filterable by type KO KO KO OK OK OK OK OK OK OK OK OK OK OK multiple scrapbooks KO KO KO KO OK OK OK OK OK KO KO KO KO KO "Page Type Icons" FileSet KO KO KO KO OK OK OK OK OK OK OK OK OK OK robots.txt embeded in c5 distribution KO KO KO KO OK OK OK OK OK OK OK OK OK OK Logging in rederect to the wanted page KO KO KO KO OK OK OK OK OK OK OK OK OK OK Files "Date Added" and "Active Version" KO KO KO KO OK OK OK OK OK OK OK OK OK OK Exclude From Nav in PageList KO KO KO KO OK OK OK OK OK OK OK OK OK OK Package::uninstall() support KO KO KO KO OK OK OK OK OK OK OK OK OK OK File, Page and User Attributes unified Framework KO KO KO KO KO OK OK OK OK OK OK OK OK OK Native storage for attributes KO KO KO KO KO OK OK OK OK OK OK OK OK OK Address attribute for users KO KO KO KO KO OK OK OK OK OK OK OK OK OK Addon Upgrade support KO KO KO KO KO OK OK OK OK OK OK OK OK OK Timed groups KO KO KO KO KO OK OK OK OK OK OK OK OK OK Mail Importers POP3 support KO KO KO KO KO OK OK OK OK OK OK OK OK OK Private Messaging KO KO KO KO KO OK OK OK OK OK OK OK OK OK PHP 5.3 support KO KO KO KO KO OK OK OK OK OK OK OK OK OK PHP 5.1 support OK OK KO KO KO OK OK OK OK OK OK OK OK OK Builtin PHP Zip usage KO KO KO KO KO KO OK OK OK OK OK OK OK OK Layout engine KO KO KO KO KO KO OK OK OK OK OK OK OK OK Task Based Permissions KO KO KO KO KO KO OK OK OK OK OK OK OK OK Zend_Cache usage KO KO KO KO KO KO OK OK OK OK OK OK OK OK Files Stats KO KO KO KO KO KO OK OK OK OK OK OK OK OK File Type Attribute KO KO KO KO KO KO OK OK OK OK OK OK OK OK Permissions on Scrapbooks KO KO KO KO KO KO OK OK OK KO KO KO KO KO SSL/TLS smtp support KO KO KO KO KO KO OK OK OK OK OK OK OK OK Block::validate() support KO KO KO KO KO KO OK OK OK OK OK OK OK OK Addon localization support KO KO KO KO KO KO OK OK OK OK OK OK OK OK Jobs support in packages KO KO KO KO KO KO OK OK OK OK OK OK OK OK elements support in packages KO KO KO KO KO KO OK OK OK OK OK OK OK OK Areas/Blocks Custom designs via Design Engine KO KO KO KO KO KO OK OK OK OK OK OK OK OK File "Originally Added To" field KO KO KO KO KO KO KO OK OK OK OK OK OK OK Blog related Blocks KO KO KO KO KO KO KO OK OK OK OK OK OK OK nav_target custom attribute KO KO KO KO KO KO KO OK OK OK OK OK OK OK dates localization KO KO KO KO KO KO KO OK OK OK OK OK OK OK Composer KO KO KO KO KO KO KO KO OK OK OK OK OK OK PHP 5.4.3 deprecation compat KO KO KO KO KO KO KO KO OK OK OK OK OK OK 5.5 like new interface KO KO KO KO KO KO KO KO KO OK OK OK OK OK Stacks KO KO KO KO KO KO KO KO KO OK OK OK OK OK white labelling support KO KO KO KO KO KO KO KO KO OK OK OK OK OK Attribute Sets KO KO KO KO KO KO KO KO KO OK OK OK OK OK Content Exporter Format (XML) KO KO KO KO KO KO KO KO KO OK OK OK OK OK Global Areas in themes KO KO KO KO KO KO KO KO KO OK OK OK OK OK Dashboard blocks KO KO KO KO KO KO KO KO KO OK OK OK OK OK concrete5 new js dialog KO KO KO KO KO KO KO KO KO OK OK OK OK OK dashboard elements can be added in packages KO KO KO KO KO KO KO KO KO OK OK OK OK OK builtin image editor KO KO KO KO KO KO KO KO KO KO KO OK OK OK New Permission system KO KO KO KO KO KO KO KO KO KO KO KO OK OK Group rights combinations KO KO KO KO KO KO KO KO KO KO KO KO OK OK Group Sets KO KO KO KO KO KO KO KO KO KO KO KO OK OK Fine grained permissions KO KO KO KO KO KO KO KO KO KO KO KO OK OK New Workflow system KO KO KO KO KO KO KO KO KO KO KO KO OK OK Mobile support KO KO KO KO KO KO KO KO KO KO KO KO OK OK New SEO Manager KO KO KO KO KO KO KO KO KO KO KO KO OK OK Versionnable Page Themes property KO KO KO KO KO KO KO KO KO KO KO KO OK OK Versionnable Page Types property KO KO KO KO KO KO KO KO KO KO KO KO OK OK Html Tab based comparison for pages KO KO KO KO KO KO KO KO KO KO KO KO OK OK Garavatar support KO KO KO KO KO KO KO KO KO KO KO KO OK OK Log "user" entry KO KO KO KO KO KO KO KO KO KO KO KO OK OK Packaged theme override KO KO KO KO KO KO KO KO KO KO KO KO OK OK New Page Cache Library KO KO KO KO KO KO KO KO KO KO KO KO KO OK

Behaviors

Behaviors 5.0.0 5.1.1 5.2.1 5.3.1 5.3.2 5.3.3 5.4.0 5.4.1 5.4.2 5.5.0 5.5.1 5.5.2 5.6.0 5.6.1 setAttribute refresh cache KO KO OK OK OK OK OK OK OK OK OK OK OK OK Group Selector KO KO OK OK OK OK OK OK OK OK OK OK OK OK $appVersionRequired in addons KO KO OK OK OK OK OK OK OK OK OK OK OK OK Loader::element local search first KO KO OK OK OK OK OK OK OK OK OK OK OK OK Advanced Permissions fixed KO KO OK OK OK OK OK OK OK OK OK OK OK OK addHeaderItem remove duplicates KO KO OK OK OK OK OK OK OK OK OK OK OK OK Dialog css classes split from core KO KO OK OK OK OK OK OK OK OK OK OK OK OK inc() search in local template KO KO OK OK OK OK OK OK OK OK OK OK OK OK c5 content encoding fix KO KO KO OK OK OK OK OK OK OK OK OK OK OK Area::getTotalBlocksInArea() KO KO KO OK OK OK OK OK OK OK OK OK OK OK ENABLE_DELEVOPER_OPTIONS KO KO KO OK OK OK OK OK OK OK OK OK OK OK BlockController::getCollectionObject() KO KO KO OK OK OK OK OK OK OK OK OK OK OK IE6 warning to users KO KO KO KO OK OK OK OK OK OK OK OK OK OK autoload css/js fix for simple blocks having only view.php KO KO KO KO OK OK OK OK OK OK OK OK OK OK addHeaderItem() support in BlockController::edit and add KO KO KO KO KO OK OK OK OK OK OK OK OK OK getTemporaryDirectory() stays in files KO KO KO KO KO OK OK OK OK OK OK OK OK OK Color Picker works with IE7/8 KO KO KO KO KO OK OK OK OK OK OK OK OK OK event::extend() multiple hooks for one event type KO KO KO KO KO KO KO OK OK OK OK OK OK OK BlockView::getThemePath() fix KO KO KO KO KO KO KO OK OK OK OK OK OK OK ccm.sitemap js and css load through helper KO KO KO KO KO KO KO OK OK OK OK OK OK OK Loader::model() ltakes local files first KO KO KO KO KO KO KO OK OK OK OK OK OK OK Loader::library() takes local files first KO KO KO KO KO KO KO OK OK OK OK OK OK OK Loader::packageElements() takes local files first KO KO KO KO KO KO KO OK OK OK OK OK OK OK EMAIL_ADDRESS_REGISTER_NOTIFICATION KO KO KO KO KO KO KO OK OK OK OK OK OK OK EMAIL_ADDRESS_REGISTER_NOTIFICATION_FROM KO KO KO KO KO KO KO OK OK OK OK OK OK OK MailHelper::replyTo() KO KO KO KO KO KO KO OK OK OK OK OK OK OK BlockView::getBlockPath() takes local files first KO KO KO KO KO KO KO OK OK OK OK OK OK OK Loader::controller() takes local files first KO KO KO KO KO KO KO OK OK OK OK OK OK OK Automatic Block Add/Edit template KO KO KO KO KO KO KO KO KO OK OK OK OK OK get() and post() default parameters KO KO KO KO KO KO KO KO KO OK OK OK OK OK Stack::display() KO KO KO KO KO KO KO KO KO KO OK OK OK OK FormHelpers::label miscFields support KO KO KO KO KO KO KO KO KO KO OK OK OK OK max/max Width/Height for editor support KO KO KO KO KO KO KO KO KO KO KO OK OK OK Color Picker UI consistent with 5.5 KO KO KO KO KO KO KO KO KO KO KO KO OK OK css()/javascript() uniqueness param KO KO KO KO KO KO KO KO KO KO KO KO OK OK BASE_URL_SSL constant KO KO KO KO KO KO KO KO KO KO KO KO OK OK __call() controller task support KO KO KO KO KO KO KO KO KO KO KO KO OK OK dashboard eleements install_post in package KO KO KO KO KO KO KO KO KO KO KO KO OK OK including t2() localization function KO KO KO KO KO KO KO KO KO KO KO KO OK OK SITEMAP_APPROVE_IMMEDIATELY KO KO KO KO KO KO KO KO KO KO KO KO KO OK ENABLE_TRANSLATE_LOCALE_EN_US KO KO KO KO KO KO KO KO KO KO KO KO KO OK

If you find any discrepancies in the above data, please a new forum topic below.