How it works

EventON provides the filter `evo_tax_archieve_page_shortcode` that lets you modify the shortcode arguments right before the upcoming events list is rendered.

Filter signature:

add_filter( 'evo_tax_archieve_page_shortcode', 'your_function_name', 10, 3 );
function your_function_name( $shortcode_args, $taxonomy_slug, $term_id ) { 
  // modify $shortcode_args here return $shortcode_args; 
}

add_filter( 'evo_tax_archieve_page_shortcode', 'your_function_name', 10, 3 );
function your_function_name( $shortcode_args, $taxonomy_slug, $term_id ) { 
  // modify $shortcode_args here return $shortcode_args; 
}

• $shortcode_args — array of shortcode parameters (what you want to change)
• $taxonomy_slug — current taxonomy (event_type, event_location, event_organizer, etc.)
• $term_id — ID of the current term/archive being viewed

Where to place the code

Paste your custom code in one of these locations (best practice order):

1. Child theme’s functions.php
2. Custom functionality plugin
3. Code Snippets plugin (recommended for non-developers)

Example: Basic customization

add_filter('evo_tax_archieve_page_shortcode', 'customize_eventon_tax_upcoming', 10, 3);

function customize_eventon_tax_upcoming($args, $taxonomy, $term_id) {

    // Apply changes to all taxonomy archive pages
    $args = array_merge($args, [
        'number_of_months'   => 6,           // look ahead 6 months
        'event_count'        => 10,          // show max 10 events
        'show_et_ft_img'     => 'yes',       // display featured images
        'eventtop_style'     => '2',         // clean / minimal layout
        'hide_mult_occur'    => 'yes',       // hide duplicate repeating events
        'hide_empty_months'  => 'yes',
        'ux_val'             => '3',         // open events in lightbox
        'show_location'      => 'yes',
        'show_etime'         => 'yes',       // show end time
        'show_year'          => 'no',
    ]);

    return $args;
}

add_filter('evo_tax_archieve_page_shortcode', 'customize_eventon_tax_upcoming', 10, 3);

function customize_eventon_tax_upcoming($args, $taxonomy, $term_id) {

    // Apply changes to all taxonomy archive pages
    $args = array_merge($args, [
        'number_of_months'   => 6,           // look ahead 6 months
        'event_count'        => 10,          // show max 10 events
        'show_et_ft_img'     => 'yes',       // display featured images
        'eventtop_style'     => '2',         // clean / minimal layout
        'hide_mult_occur'    => 'yes',       // hide duplicate repeating events
        'hide_empty_months'  => 'yes',
        'ux_val'             => '3',         // open events in lightbox
        'show_location'      => 'yes',
        'show_etime'         => 'yes',       // show end time
        'show_year'          => 'no',
    ]);

    return $args;
}

Conditional customization (recommended for most projects)

Apply changes only to specific taxonomies or even specific terms.

Example: Different style only for event locations

add_filter('evo_tax_archieve_page_shortcode', 'custom_location_archive_events', 10, 3);

function custom_location_archive_events($args, $taxonomy_slug, $term_id) {
    if ($taxonomy_slug !== 'event_location') {
        return $args;
    }

    $args['eventtop_style']     = '0';          // boxed style
    $args['show_et_ft_img']     = 'yes';
    $args['number_of_months']   = 4;
    $args['event_count']        = 8;
    $args['show_location']      = 'no';         // redundant on location archive
    $args['ux_val']             = '3a';         // lightbox + external link when available

    return $args;
}

add_filter('evo_tax_archieve_page_shortcode', 'custom_location_archive_events', 10, 3);

function custom_location_archive_events($args, $taxonomy_slug, $term_id) {
    if ($taxonomy_slug !== 'event_location') {
        return $args;
    }

    $args['eventtop_style']     = '0';          // boxed style
    $args['show_et_ft_img']     = 'yes';
    $args['number_of_months']   = 4;
    $args['event_count']        = 8;
    $args['show_location']      = 'no';         // redundant on location archive
    $args['ux_val']             = '3a';         // lightbox + external link when available

    return $args;
}

Most useful shortcode parameters for taxonomy archives

Read Shortcode Guide for more Shortcode Parameters.

Tips

• Use event_count when you want a fixed number of events instead of time-based.
• Combine hide_mult_occur=yes with event_count for cleaner lists.
• Test lightbox behavior (ux_val) — 3 is usually the best balance.
• If you want completely different content, consider overriding the template instead of just modifying the shortcode.

The post How to Customizing the Upcoming Events List on Event Taxonomy Archive Pages first appeared on Documentation.

• Scheduled
• Cancelled
• Moved Online
• Postponed
• Rescheduled
• Preliminary
• Tentative

In this guide, we’ll cover how to add two new statuses “Sold Out” and “Pending Approval”.

To get started, please open your theme editor by going to Appearance > Theme File Editor and paste the following code into the functions.php file:

/**
 * Add custom EventON statuses for your events
 *
 * @since EventON 4.5
 *
 * @return array
 */
add_filter( 'evo_event_statuses', 'my_custom_evo_event_status' );
 
function my_custom_evo_event_status( $statuses ) {
	
	// Add a 'sold out' and 'pending approval' event status
	$new_statuses = array(
		'sold_out'=>array(evo_lang('Sold Out'), __('Sold Out','eventon') ),
		'pending_approval'=>array(evo_lang('Pending Approval'), __('Pending Approval','eventon') )
	);

	return array_merge($statuses, $new_statuses);
}

In case you’d like to protect your code from future theme updates, please create a new PHP snippet using the Code Snippets Plugin or the WPCode Plugin.

Once the code has been successfully saved on your site, the new statuses should be visible when editing new and old events as shown below:

The post How to Add a Custom Event Status first appeared on Documentation.

How to enabled Plugin Editor

1. User FTP to connect to your website host and go to the directory where you website is hosted.
2. Open the wp-config.php file from the wordpress install of your website
3. Search for “define(‘DISALLOW_FILE_EDIT’, true);
4. Change the true value to false  — define(‘DISALLOW_FILE_EDIT’, false);
5. Save the file and upload back again.

Security Risks Involved

Enabling plugin editor pose some risks as well. Obvious risk is someone that gained access to your site could edit a plugin or they could use this to add any code they want.

The post How to enable Plugin Editor for WordPress first appeared on Documentation.

There are two types of hook: actions and filters.

• Action Hooks allow you to insert custom code at various points (wherever the hook is run).
• Filter Hooks allow you to manipulate and return a variable which it passes (for instance a product price).

Here is an excellent article on hooks and filters here,.

Using Hooks

If you use a hook to add or manipulate code, you can add your custom code to your theme’s functions.php file.

Using action hooks

To execute your own code, you hook in by using the action hook do_action('action_name');. Here is where to place your code:

add_action( 'action_name', 'your_function_name' );

function your_function_name() {
// Your code
}

Using filter hooks

Filter hooks are called throughout are code using apply_filter( 'filter_name', $variable );. To manipulate the passed variable, you can do something like the following:

add_filter( 'filter_name', 'your_function_name' );

function your_function_name( $variable ) {
// Your code
return $variable;
}

With filters, you must return a value.

The post How to use Actions and Filters first appeared on Documentation.

add_filter('evo_max_cmd_count','custom_function_2',10,1);
function custom_function_2($number){
  return 16;
}

The post How to get more custom event data fields first appeared on Documentation.

add_filter('eventon_lang_var_count','eventon_lang_count', 10, 1);
add_filter('eventon_lang_variation','eventon_lang_vars', 10, 1);
function eventon_lang_count($count){
	// return 6 to support 3 additional languages on top of 3 existing ones
	return 6;
}
function eventon_lang_vars($array){
	// add our additional 3 languages
	$new_array = array('L4','L5','L6');
	return  array_merge($array, $new_array);
}

The post How to Include Additional Languages first appeared on Documentation.

Event Taxonomy Meta Values

Since version 2.4 event location and organizer data for each event is saved in respective taxonomy and taxonomy meta.

(Before version 2.4.7) You can use get_option(‘taxonomy_{$ID}’) where ID is the taxonomy term ID.

(From version 2.4.7) All the taxonomy meta values are saved in wordpress options and can be fetched using get_option( “evo_tax_meta”); sorted by taxonomy name and taxonomy term ID.

Event Location and Organizer

Location and organizer for events are saved as taxonomies in wordpress since eventon version 2.4. Meta data mentioned below for location and organizer are saved as term meta.

Taxonomy Meta Data Fields

Event Location

location_address – location address

location_lon & location_lat – longitude and latitude values for the address

evcal_location_link – link to a location

evo_loc_img – location image attachment ID for wordpress media

Event Organizer

evcal_org_contact – organizer contact information

evcal_org_address – organizer address

evcal_org_exlink – external link to organizer to be linked to

_evocal_org_exlink_target – whether to open external link in new window or not

evo_org_img – organizer image attachment ID for wordpress media

Term Meta Data Handling

Location and organizer term meta data can be accessed and updated from below functions.

Get Location and Organizer Taxonomy Meta Data

evo_get_term_meta($tax, $term_id);

$tax = the taxonomy name

$term_id = taxonomy term ID for the location or organizer

Return

This function will return an array of taxonomy meta data or false on empty.

Save Location and Organizer Taxonomy Meta Data

evo_save_term_metas($tax, $term_id, $data);

$tax = the taxonomy name

$term_id = taxonomy term ID for the location or organizer

$data(array) = Must be sent as an array of data with meta data field as the array key.

eg. $data = array(‘evcal_org_contact’=>’Contact Information’);

Return none.

Basic Custom Usage

<?php

	$event_terms = get_terms(
		'event_type',
		array(
			'orderby'=>'name',
			'hide_empty'=>true
		)
	);

	if(!empty($event_terms) && !is_wp_error($event_terms)){
		foreach($event_terms as $event_term){
			// code for each event term
			echo $event_term->name;
		}
	}

?>

Get Event’s Terms

<?php
	$taxonomy = 'event_location';
	$event_terms = wp_get_post_terms($p_id, $taxonomy);
	if ( $event_terms && ! is_wp_error( $event_terms ) ){
		$event_location_term = $event_terms[0];
		$location_name = $event_location_term->name;
	}
?>

More on get terms.

The post Taxonomies of EventON first appeared on Documentation.

Hooks are provided by WordPress and EventON to allow your plugin or theme to hook into the code to call functions in your plugin at specific times. There are two kinds of hooks:

Actions: Actions are hooks are lauched at specific points during execution or when specific events occur.

Filters: Filters are hooks that modify data before they are returned.

Below is a list of Actions and Filters used in EventON.

Actions:

In class-calendar-generator.php

eventon_cal_variable_action

eventon_cal_end

eventon_eventcard_additions

eventon_sorting_filters

eventon_below_sorts

eventon_after_loadbar

in class-calendar-body.php

eventon_cal_variable_action_au

eventon_calendar_header_content

evo_cal_footer

in class-calendar-shell.php

eventon_event_sorting_{$sort_by}

in eventon.php

eventon_init

eventon_enqueue_scripts

eventon_activate

eventon_deactivate

Filters:

in class-calendar-generator.php

eventon_wp_query_args

eventon_event_frequency_{$frequency}

eventon_evt_fe_ptime

eventon_evt_fe_time

eventon_eventcard_date_html

eventon_eventcard_array

eventon_eventtop_one

eventon_eventtop_two

eventon_eventtop_html

eventon_event_cal_short_info_line

eventon_so_filters

in class-calendar-shell.php

eventon_shortcode_defaults

eventon_calhead_shortcode_args

in eventon.php

eventon_template_url

eventon_google_map_url

The post Hooks: Actions & Filters first appeared on Documentation.

Event Location and organizer information is saved into taxonomy instead of event post meta since version 2.4 – Taxonomies of EventON

Array Event Post Meta Data

EventON also contains some of event post meta data as sanitized array saved inside a single event post meta field _edata

How to access event array meta data

You can use Evo_Event object to access the event array meta data. Below is one example.

// 4 = an example event ID
$EVENT = new EVO_Event(4);

// get all event array meta data
$all_array_data = $EVENT->get_all_edata();

// get just one field from the meta array
$one_field = $EVENT->get_eprop('field_name');

Values stored in array event post meta

Event Health Guidelines Data

_health_mask — yes/no

_health_temp — yes/no

_health_pdis — yes/no

_health_san — yes/no

_health_out — yes/no

_health_other — yes/no

The post Event Post Meta Variables first appeared on Documentation.

Use this function to display the EventON calendar inside a page template. This function does not need to be placed inside the WP loop.

Note: ajde_evcal_calendar() function also support how ever this function is deprecating.

Usage

<?php
if( function_exists('add_eventon')) {
	add_eventon($args); 
}
?>

NOTE: $args variable is used only when you are passing other variable values to the calendar.

Default Usage

<?php $args = array(
    'cal_id'        	=> 1,
    'month_incre'      	=> +2,
    'event_count'      	=> 3,
    'show_upcoming'     => 0,
    'number_of_months'  => 2,
    'event_type'      	=> '3,4,1',
    'event_type_2'     	=> '4,7',
); ?>

Parameters

cal_id

(integer/string) (optional) This is a unique id that could be set to identify a single calendar (if there are multiple calendars in a single page). The cal_id can be any number, letters, or combination of both that you can come up with – only requirement is that it is unique.

event_type

(integer)  List of event type taxonomy tag IDs separated by commas. Default is ‘all’.

event_type_2

(integer) List of event type 2 taxonomy tag IDs separated by commas. Default is ‘all’.

month_incre

(integer) Is the offset number of months in a +/- integer representing the offset that will push the starting month of the calendar by this offset number. Default is 0.

event_count

(integer) Number of events to show per month in the calendar. Default is 0.

show_upcoming

(integer) Enable upcoming events list on the calendar. Default is 0 (false).

• 0 – default, no upcoming list
• 1 – show upcoming list

number_of_months

(integer) Specify the number of months to show in the case of upcoming months list. MUST  be used with show_upcoming parameter. Default is 0.

The post Template Tag: add_eventon first appeared on Documentation.