Perch Update 1.7

We’ve updated Perch with a number of new features as well as some bug fixes for issues discovered via our support system.

Please back up your site and database before updating. Run the /perch/update script once you have copied the files, and due to database changes, be sure to save any region before changing its settings or deleting items. Note that this update includes some additional files to copy into your config and templates folders.

Do I need to install this?

There’s no need to install immediately. You should update when it’s next convenient to do so. This release contains a number of small bug fixes.

What does it fix?

This release fixes the below issues:

• Fixed an issue with blank maps and perch:if tags
• Fixed a bug that generated ra-xxx-xxx format slugs
• userLastLogin field now updated on login

Users experiencing these issues should update when convenient.

What features does it add?

• Added <perch:forms /> functionality for creating forms
• Added search functionality
• New option to send/not send welcome email when creating a user
• Content edit button bar goes red when there’s an error on the page
• Switched email fields to HTML5 email type
• Added <perch:setting /> runtime tags
• Added <perch:noresults> tags for custom content regions
• Added PERCH_HTML5 configuration constant for outputting HTML5 markup. On by default in new installs.
• Added new size attribute to textarea fields: xs, s, m, l, xl, xxl
• Updated jQuery 1.6.2
• Updated to MarkItUp! 1.1.12
• API: PerchBase::update() now returns a value.
• API: Added file_field option to Form API
• API: PerchAPI_Image::resize_image() now returns array of image paths and dimensions
• API: Added require_version() API method for apps to assert a required Perch version
• API: Added PerchAPI_Template::apply_runtime_post_processing() method for runtime processing of forms
• API: New PerchAPI_Email class for sending emails
• API: Added new size attribute to textarea fields to API
• API: Added SearchHandler API for apps to integrate into search results

What impact does it have for my clients?

Editors should not notice any major differences to the interface.

Where do I get the update?

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

Make a back-up of your files and database.

No, really. Make a back-up. There’s always someone who doesn’t and manages to delete the wrong files – don’t let that be you.

Unzip and replace your existing files with the exception of:

• config
• resources
• templates
• plugins – if you have added to this
• Additional apps in apps – just copy apps/content

These contain information specific to your installation and should not be overwritten. There is no need to copy setup, as you’re already up and running.

There are also some new files to copy into existing folders:

• config/filetypes.ini
• templates/search

Then visit /perch/update in your browser. That’s all you need to do – Perch is now updated.

Previous updates

• Update to Perch 1.6.5