Custom Files Add-on Documentation

The Custom Files add-on provides PHP files that allow you to override certain aspects of the Event Espresso. For example, you can override some of the core functions. There are also sample templates that can be used along with example shortcodes to provide table layouts. You can also add your own functions that you would like included when the plugin runs.

View quick links for this add-on –> 

Installation

This add-on is not a plugin for WordPress and cannot be installed through your WP dashboard (WP-admin).

Step 1: Download the latest version of the Custom Files add-on from your Event Espresso account. Then unzip the folder and make a note of its location on your computer.

Step 2: Login to your WordPress site with your preferred SFTP or FTP client. FileZilla and Cyberduck are free options.

Step 3: Browse to this location using your SFTP or FTP client:
/wp-content/uploads/espresso/

Step 4: Locate the following files on your computer in the folder that you unzipped in step 1:

custom_includes.php

custom_functions.php

custom_shortcodes.php

Step 5: Upload the files above to the following location:
/wp-content/uploads/espresso/

Step 6: Browse to this location using your SFTP or FTP client:
/wp-content/uploads/espresso/templates

Step 7: Upload any templates from the add-on folder to this location:
/wp-content/uploads/espresso/templates

Note: the custom_*.php files are uploaded to /wp-content/uploads/espresso
Template files which are different are uploaded to /wp-content/uploads/espresso/templates

Usage

This add-on is helpful for organizing customizations to Event Espresso 3. You should never modify the core plugin in /wp-content/plugins/event-espresso as your edits will be lost on a software update.

The Custom Files add-on is an ideal spot to add these changes.

custom_includes.php – Should be used to include your custom templates or any other files you need loaded into the plugin
custom_functions.php – Place all of your custom functions in this file
custom_shortcodes.php – Place all of your custom shortcodes in this file

Troubleshooting

The plugin will not install. Can you help?
This plugin is not a WordPress plugin so it cannot be installed through the WP dashboard. Please take a look at the installation section in this article for how to install this add-on.

Customizations

• Have you found a custom code snippet in our support forums? The custom_functions.php file is a good spot to add that code snippet!