Perch Update 2.4

We’ve updated Perch with some new features and a number of bug fixes discovered through our support system. This is an update to Perch 2. Please read the full Perch 2.0 update notes if updating from Perch 1.

Do I need to install this?

This update is recommended for those wanting to try the new features or those wanting to receive technical support.

What does it fix?

This release fixes the below issues:

  • Fixes some layout issues at very small screen sizes
  • Fixes bug where new pages referencing master pages didn’t transfer well between Windows and Linux
  • Fixes potential image resize rounding issue for some builds of GD
  • Changes image crop behaviour to accept crops where only one dimension changes
  • Fixes bug with image file naming for non-integer image densities
  • Fixes bug where hidden templates weren’t shown in the region options template list
  • Fixes bug with editing maps within apps (API issue)
  • Fixes errors with search result excerpts
  • Fixes URL encoding problem when redirecting after logging back in after a session timeout
  • Fixes missing file icon on API file upload fields
  • Fixes preview for regions in list/detail edit mode (needs ‘single item URL’ setting)
  • Updates jQuery
  • Fixes scrollTop warning in JavaScript console.

What features does it add?

This release adds the following features and improvements:

  • Adds divider-before and divider-after attributes to template tags (docs)
  • Adds SmartyPants to Markdown formatting
  • Adds an option to create a page in a new folder
  • Adds option to move a page’s file when changing the path
  • Adds page attributes, along with perch_page_attributes() and perch_page_attribute() (docs)
  • Adds smarttext field type (docs)
  • Adds full item content availability to search results template (docs)
  • Adds a View Page button to the edit form smart bar
  • Simplifies the main Pages listing, removing the ‘Type’ column
  • Adds Ctrl-E to Edit option from site pages (requires perch_get_javascript() on the page) (docs)
  • Adds keyboard shortcut to save content with Ctrl-S or Cmd-S is used (where browser allows override)
  • Adds ‘each’ option to perch_content_custom() to provide a custom PHP callback function (requires PHP 5.3) (docs)
  • Adds apps option to search a subset of apps (docs)
  • Adds new templates/pagination default templates (docs)
  • Adds page-links, page-link-template and page-link-style options wherever paginate is used (docs)
  • Adds page modified date and perch_page_modified() (docs)
  • Adds the website URL setting to the link for the current page in the edit form sidebar
  • Adds rescope="parent" to perch:template tags to change the namespace to that of the including template (docs)
  • Adds PERCH_DATE_LONG, PERCH_DATE_SHORT, PERCH_TIME_LONG and PERCH_TIME_SHORT constants for admin date display
  • Adds the ability to pass an array of region keys to perch_content_custom() (docs)
  • Adds no-conflict option to search (docs)
  • Adds editor-config attribute for textareas – gets added as a data- attributes
  • Adds new PERCH_HTML_ENTITIES switch to enable use of HTML entities rather than unicode characters
  • Adds ‘Shared’ page to Pages dashboard widget
  • Adds _sortedvalue to perch_content_custom() output to show what value the item was sorted on
  • Adds PerchAPI_SubmittedForm::$page property
  • Removes perch_content_custom() legacy compatibility mode
  • Updates help text, Markdown and Textile guides
  • Default templates now use Markdown instead of Textile

What impact does it have for my clients?

The Page Options view has been split down into Page Options and Page Details. Options includes technical settings, whereas Details includes page title, navigation title and any page attributes (new feature).

If your client uses Page Options to change page title etc, it would be worth familiarising them with the changes.

Other interface changes include a simplified Pages listing.

Where do I get the update?

Log into your account and re-download the files. The download has been replaced with the newest version.

Always make a back-up of your files and database before updating.

Unzip the download and replace your perch/core folder with the new perch/core folder. Perch will update itself when you log in.

New default templates

This release includes some new templates, which would be useful to copy into your site.

  • templates/pagination
  • templates/pages/attributes

These are not essential for an existing site, but are useful and exist for new installations so are recommended.

Previous updates