Event Alerts

Event Alerts
Event Alerts plugin, registered users on your site can create event alerts based on searches (by keyword, location keyword, category) which are delivered by email either Daily,Weekly and Fortnightly.

 

Installation
You can install Event Alerts plugin using 2 different ways:
 
[1] Automatic Installation : You can install plugin from backend of your WordPress. Click Here to see how you can do automatic installation.
 
[2] Manual Installation : You can install plugin manually using SFTP or FTP tool as well. Click Here to see how you can do manual installation.
 
Watch this video for more clarification.
 
Event Alert Settings
Once you installed and activated the Event Alert plugins on your site, you will get event alert setting options in backend at WP-admin >> Event Listings >> Settings >> Event Alerts. You as an admin can change the Alert Email Content, Alert Duration, etc. from theme backend.
 
Alert Settings From Backend – Admin Panel
 
  • Alert Email Content: Enter the content for your email alerts.
  • Alert Duration: Enter the number of days before alerts are automatically disabled, or leave blank to disable this feature. By default, alerts will be turned off for a search after 90 days.
  • Alert Matches: If you enable “Send alerts with matches only” option, then it will send an alert only when events are found matching its criteria. When that option is disabled, an alert is sent regardless.
  • Alerts Page ID: Select “Event Alert” page from drop-down where you have placed the [event_alerts] shortcode. So that the plugin knows where to link users to view their alerts.
 
Event Alert Form
If user is logged in, visiting the event detail page(if you have the event alert plugin installed) will show you “Alert me to events like this” button at sidebar area of event detail page. Clicking on that button, you will be redirecting to event alert page that will look something like this:
 
Event Alert Form
 
How to create Event Alerts Based On Filters?
Users don’t need to get annoying alerts about the events they’re not even interested in, they have the option to create event alerts based on filters. They can choose any filter like event type, category and only get the alerts for the ones they want to.
 
If you are logged in, you can save your filter event as an alert using the ‘add alert’ button. Also, they can also choose the frequency at which they want to receive the email event alerts.
 
Create Event Alerts Based On Filters
 
How To Get Event Alert Dashboard?
How will the visitors be able to manage the event alerts and update them. For this, the plugin provides an event alert management dashboard. As you can see in the image, there are some splendid options that you can use to do so.
 
From here, you can change the email on which you want to get the email alert, edit, update or delete the event alert information.
 
Event Alert Dashborad
 
For that, create a new page from WP-admin >> Pages >> Add New and name it something along the lines of “Event Alert” or “My Event Alert” and then inside the content area add this below shortcode: content area add the shortcode:
[event_alerts]
It is best to insert the shortcode into the “text” view of the visual editor to ensure it gets formatted correctly.
 
The Shortcode Setup
 
Advanced: Controlling/Adjusting alert button and alert form place

The alert form is hooked into the event page after the event meta place as shown below:

add_action( 'single_event_listing_button_end', array( $this, 'single_alert_link' ) );

To remove and move to different place, you can do like this:

/**
* Move my alert message place to perfect place.
* Show my alert message after button section that way we have hooked 'single_event_listing_button_end' hook and it will show at after button section.
* @param  array $steps
* @return array
* @since 1.0.0
*/ 
function move_my_alert_events_message() 
{
global $event_manager_alerts;

if ( has_action(  'single_event_listing_meta_after', array( $event_manager_alerts, 'single_alert_link'  )) )
{
   remove_action( 'single_event_listing_meta_after', array( $event_manager_alerts, 'single_alert_link' ) );
}

if ( has_action('single_event_listing_button_end', array( $event_manager_alerts, 'single_alert_link')))
{
    remove_action( 'single_event_listing_button_end', array( $event_manager_alerts, 'single_alert_link' ) );    
    add_action( 'single_event_listing_button_end', array( $event_manager_alerts, 'single_alert_link' ) );       
}
else
{
   add_action( 'single_event_listing_button_end', array( $event_manager_alerts, 'single_alert_link' ) );    
}   


}
add_action( 'wp', 'move_my_alert_events_message', 12 );
In General, You can use your choice of custom hook to append the form to a different place.
global $event_manager_alerts;
                add_action( 'your_custom_hook', array( $event_manager_alerts, 'single_alert_link' ) );

 

Advanced: Overriding/Customizing the templates

For overriding or customization template files can be found in the wp-event-manager-alert/templates/ directory. To override a template file, first you need to create directory “wp-event-manager-alert” under your theme folder and copy the template file to “/wp-content/yourtheme/wp-event-manager-alert/” directory. Your theme will use all the template files from the “/wp-content/yourtheme/wp-event-manager-alert/” directory instead of the plugin’s template file (/wp-content/plugins/wp-event-manager-alert/).

  • my-alerts.php template file lists the user’s alerts.
  • alert-form.php template file which controls the alerts form display on events page.

Remember: If you have overrided template file and plugin frequently updating then you need to sync template file with new updates from the plugin’s template file for better functionality and new features.