Support

Home Forums Custom Files Add-on (EE3) Altering event espresso templates

Altering event espresso templates

Posted: October 30, 2013 at 8:07 am


moochers bars

October 30, 2013 at 8:07 am

Latest version of EE, with: Calendar, MailChimp Integration, Multi Event Reg, Recurring Events, Social Media and Ticketing add-ons.

Two part question (and possibly schoolboy error).

Throughout the event registration process we want to make changes to the wording used on buttons, in instructions, information labels etc (to remove ‘registration’ to focus on ‘ticket purchase’) and hide the odd bit of information from the user (client doesn’t want the number of tickets left to be shown in case it has negative impact on sales for instance).

I’m not a PHP developer, but i’ve worked with enough different programming syntaxes to make educated guesses – so I’m trawling through the event-espresso/templates folder and can see what I want to alter.

So to the two part question:
1) If I alter these templates do I put them in the wp-content/uploads folder rather than replacing the templates directly in the event-espresso/templates folder ?

and if so

2) Does that mean that if the template files get updated significantly in a future release that I might inadvertantly miss out on new features?


Tony

  • Support Staff

October 30, 2013 at 8:30 am

Hi Moochers,

1) Yes that’s correct when modifying the templates copy them to wp-content/uploads/templates.

The reason behind this is if you spent 2 weeks modifying templates and we bring an update out, they all revert to stock 🙂 We recommend copying the templates you modify (some are in pairs like event_list and event_list_display should be copied together) to that folder so that if for some reason something goes wrong, Event Espresso can revert back to the stock templates.

2) Yes (kind of)

We try to update templates as little as possible (now I’ve said that we’ll change something…) but generally all you need to do is run them through something like DiffMerge to find the changes and add in the updated code to your templates.

Changing wording is likely better done through ‘translating’ your Event Espresso version. If you then try different themes you don’t lose all your customization’s. Have a look here:

https://eventespresso.com/wiki/how-to-change-wording-with-poedit/


moochers bars

October 30, 2013 at 8:39 am

So they’ll be automatically picked up? I don’t need to alter the three files: custom-includes.php, custom-functions.php, or custom-shortcodes.php in any way?


Tony

  • Support Staff

October 30, 2013 at 9:04 am

Which will be automatically picked up?

If you mean the templates yes, Event Espresso checks the uploads/templates folder for known templates, then if not found check /templates.

Those files mentioned are from the custom files add-on, it depends what you are using them for?


moochers bars

October 30, 2013 at 9:26 am

Didn’t know whether the custom files add-on was needed for espresso to pick up the amended templates. I’ll have a look at the translation approach longer term, but with current timescales and given I want pages to omit information I’ll run with the templates approach for the moment. Thanks for your help Tony.


Tony

  • Support Staff

October 30, 2013 at 11:55 am

No problem.

Just to clarify so you know whats happening.

Event Espresso checks wp-content/uploads/espresso/templates for a template file first.

If one is not found there it will use the default one in event-espresso/templates.

The above is all part of the core.

The Custom Files Add-on basically allows you to modify (or even add) functions/shortcodes within Event Espresso and keeps these modifications after updates. Kind of like a themes functions.php only for Event Espresso.


Matt Paul

November 4, 2013 at 3:44 pm

Question on your response.

“1) Yes that’s correct when modifying the templates copy them to wp-content/uploads/templates”.

Should it not be the following path? wp-content/uploads/espresso/templates

Default templates – are in plugins/event-espresso/templates?

Just was searching for the documentation – and I am getting a couple answers when I search.

Thanks


Dean

November 5, 2013 at 1:55 am

Hi Matt,

Yes you are correct it should be wp-content/uploads/espresso/templates, it was probably a typo on Tony’s part.

“Default templates – are in plugins/event-espresso/templates?” Correct.

If you think there is an error in the documentation, please let us know what and where, as errors always need fixing!

The support post ‘Altering event espresso templates’ is closed to new replies.

Have a question about this support post? Create a new support post in our support forums and include a link to this existing support post so we can help you.

Event Espresso