This week, we’re shipping a new version of Event Espresso — 3.1.29 — to add some new features and bugfixes and correspond with the release of WordPress 3.5. 3.5 is a major release for WordPress, with a lot of stuff happening under the hood. We’ve done our best, working with the release candidates, to catch all the bugs and there are a few key points that we wanted to point out as you prepare your sites for these updates.
CREATE A BACKUP!
I can’t stress this enough: when you are making any major changes to your site (which includes updating plugins or WordPress core), if something goes awry or there is an unforeseen bug that slipped through testing and you are without a backup, you are relying on your host to have a backup of your database — if you’re lucky, they’ll have one within the last week; if you’re less lucky, it may be as much as a month or more old. Backup before you upgrade, that way you have something to go back to immediately after something goes wrong (in the unlikely event that it does). Both WordPress and Event Espresso don’t “roll back” easily — there are still changes made in the database when you update that don’t get rolled back by just removing the newer version and putting back the older version, and you could lose data or introduce new issues by trying to “roll back” your WP or Event Espresso installation. If you are even considering “rolling back” as a failsafe, that’s even more incentive to create a backup before you update.
If you’re upgrading to WordPress 3.5, you need to upgrade Event Espresso
Like some issues we saw last year with the release of WordPress 3.4, there are a few issues that show up after upgrading to WordPress 3.5 if you are using Event Espresso 126.96.36.199 or lower. This is part of the reason we’ve been working long hours testing and bugfixing this version of Event Espresso. If you upgrade to WordPress 3.5, you will need to upgrade Event Espresso to 3.1.29 to prevent a number of front- and backend errors from showing up on your site. Additionally, if you are using the WP User Integration add-on, you will need to update to 1.9.6. Again, before upgrading anything backup your database.
Updates to Espresso Calendar
Similar to the requirement to upgrade the WP User Integration add-on to 1.9.6, you’ll need to update your calendar to 2.0.4. This update went out quietly last week, so if you’ve already upgraded your calendar to 2.0.4, you don’t need to do anything. If you haven’t upgraded to 2.0.4 yet, you’ll need to upgrade when you update WordPress otherwise your calendar will not display at all. The update in 2.0.4 updates the fullcalendar.js library to the latest version to be compatible with the newer version of jQuery included in WordPress 3.5.
Since compression from php can be problematic on some hosts there are several “switches” (constants) that manage it: define(‘CONCATENATE_SCRIPTS’, false); would turn off both concatenating and compressing of all scripts.
The solution, as alluded to above, is to add the following line to your
Featured images for event lists
We will be adding more documentation in our documentation pages for this new feature, but we are proud to announce the release of a new option to display featured images in your event lists. This works similarly to Featured Images elsewhere in WordPress, though we are not using the same system, so if you are familiar with WordPress theme development, this will still be somewhat different than what you’re used to.
Add to calendar feature
This has been on the back burner for a long time and we finally were able to add it to this release. 3.1.29 introduces another new feature to add the event to your calendar as an .ical file (compatible with Apple, Google and Outlook calendars). The feature is also activated by default, but you’ll need to re-save your Template Settings to turn it on.
Automagic Payment Status in Attendee Payments Admin Page
When submitting a payment in the new Attendees Admin, Payment Status is automagically set depending on the relationship between Amount Paid and Amount Owing as such:
- Amount Paid < Amount Owing = Payment Status PENDING
- Amount Paid = Amount Owing = Payment Status COMPLETED
- Amount Paid > Amount Owing = Payment Status OVERPAID
So if you are trying to set the Payment Status to COMPLETED while there is STILL monies owing, then the system will override and set it to PENDING.
In other words, the only way to set Payment Status to COMPLETED is to set the Amount Paid equal to the Amount Owing.
Thousands of attendees or events? We’ve got you covered.
Event Espresso 3.1.29 addresses issues that have been experienced by people with thousands of events or attendees in the Event Overview. We revamped the administration area for managing events and managing attendees so that it loads MUCH faster if you have a lot of attendees or events in your system. The 500 record at a time limit has been removed and replaced with a new setting to only retrieve a specific number of records from the database at a time, and to paginate to the next group of results. This is better for performance than what was happening previously which occasionally caused significant server lag running huge database queries to return your results.
Recent changes to promo codes and Groupon codes
This actually isn’t new to 3.1.29 but we haven’t made a formal announcement; coupon codes now work with Multi Event Registration. To get started, set the new “Allow discounts in the shopping cart” option to Yes. Discount codes will only apply to the events that accept them (previously, coupon codes would apply to all events in the cart, which led us to disable the promo code box by default).
Another change to the way promo codes are handled is that the standard fixed price promo code will apply to each ticket. For example, a promo code good for $5 off previously would discount $5 off the entire order, now it will discount $5 for each ticket.
Groupons have been modified so that one Groupon code will apply to all the tickets for one event (similar to how promo codes used to work in the shopping cart).
Front-end edit user profile shortcode
The WP User Integration update includes some fixes to the payment confirmation page for WordPress 3.5. It also includes a major new feature we think you’ll find useful. We know how difficult it is to deal with editing user profiles for WP User Integration if you don’t want to give your users access to the WP backend. We minimized this somewhat with the addition of a My Events front-end shortcode recently, bringing the My Events page to the front end of the site. But users would still need to access the backend to update their user profile and add their address information to have those things saved for their next registration. This is why we built a shortcode that creates an edit user profile page and includes the Event Espresso profile fields. The only other way to bring these profile fields to the front end would be to code your own page or modify a plugin like Theme My Profile.
The edit user profile page also uses themeroller styles, so if you have themeroller active in your template settings, the edit profile fields will be styled accordingly. Be sure to check our documentation pages for documentation on how to use this new shortcode.
Update your add-ons
Because of recent changes to how the folder names for some of the add-ons have changed and how that ties into the automatic update system, you may not be receiving update notifications to some of the add-ons. Be sure to check your user account page for the current versions of each add-on and your Plugins page to see which versions you have installed. If you are using an older version and not receiving the update notifications, the easiest way to resolve this is to deactivate and delete the add-on from your Plugins, then download the zip file from your user profile page on eventespresso.com. Once you have the zip file, upload it to your server to install.
With great features comes…template changes
This is another thing that we say with every major release, but it bears saying every time: anyone who has templates in
/wp-content/uploads/espresso/templates will need to update their templates or all kinds of things will break if they update the plugin and do not update their templates. Every release we see errors relating to template files that are outdated. Making customizations to the templates is a powerful thing — and like all development projects, when the core software changes, the files that are dependent upon the core software need to be updated to accomodate. With WordPress plugins and themes, this means replacing deprecated functions with new functions. With Event Espresso template files, this means replacing outdated function references with filters and hooks and new features that have been added. In the case of Event Espresso 3.1.29, the major changes to the template files deal with the features I just talked about — featured images and ical links, but there were also fixes added to
We hope that you’ll take a look at the changelog to see all the things that have been updated and that you enjoy the new features that have been added. In addition to what I’ve described above, we’ve also added the Eway Rapid 3.0 gateway, and many bugfixes. As always, if you have any questions or issues, let us know in our support forums. Downloaded WordPress 3.5 and Event Espresso 3.1.29 already? Let us know your favorite features in the comments!