“Live Events” Documentation by “DAEXT” v1.25

“Live Events”

Created: 20/08/2020
By: DAEXT
Email: support@daext.com

Thank you for using Live Events. If you have any questions that are beyond the scope of this help file please contact us via email or with the contact form available in our CodeCanyon Profile.

Table of Contents

  1. Video Tutorials
  2. Installation (Single Site)
  3. Installation (Multisite)
  4. Update (Single Site)
  5. Update (Multisite)
  6. Create an Event
  7. Create a Timeline Section
  8. Create a Timeline Item
  9. Create a Timeline Item with an Image
  10. Create a Timeline Item with a Tweet
  11. Create a Timeline Item with custom HTML
  12. Create and use Timeline Icons
  13. Create a Stat Section
  14. Create a Stat Group
  15. Create a Single Data Stat Item
  16. Create a Single Visual Stat Item
  17. Create a Comparison Data Stat Item
  18. Create a Comparison Visual Stat Item
  19. Create a Comment Section
  20. Create a Comment Item
  21. Publish an Event
  22. Update a Timeline Section
  23. Update a Stat Section
  24. Update a Comment Section
  25. Credits
  26. FAQ

A) Video Tutorials

This video series covers the functionalities of the the Live Events plugin.

Please note that not all the aspects and implications are covered in this section, it's recommended that you read the entire documentation (FAQ included) before using this plugin in a production environment or asking for support to the plugin author.

B) Installation (Single Site)

With this procedure you will be able to install the Live Events plugin on your WordPress website.

  1. Visit the Plugins -> Add New menu
  2. Click on the Upload Plugin button and select the zip file you just downloaded
  3. Click on Install Now
  4. Click on Activate Plugin

C) Installation (Multisite)

This plugin supports both a Network Activation (the plugin will be activate on all the sites of your WordPress Network) and a Single Site Activation in a WordPress Network environment (your plugin will be activate on single site of the network).

With this procedure you will be able to perform a Network Activation:

  1. Visit the Plugins -> Add New menu
  2. Click on the Upload Plugin button and select the zip file you just downloaded
  3. Click on Install Now
  4. Click on Network Activate

With this procedure you will be able to perform a Single Site Activation in a WordPress Network environment:

  1. Visit the specific site of the WordPress Network where you want to install the plugin
  2. Visit the Plugins menu
  3. Click on the Activate button

D) Update (Single Site)

With this procedure you will be able to update the Live Events plugin:

  1. Visit the Plugins menu
  2. Click on Deactivate
  3. Update the plugin files with your favorite FTP client (delete the files of the old version and add the files of the new version)
  4. Click on Activate

E) Update (Multisite)

To update the plugin in all the sites of your WordPress Network follow this procedure:

  1. Visit the Plugins menu
  2. Click on Network Deactivate
  3. Update the plugin files with your favorite FTP client (delete the files of the old version and add the files of the new version)
  4. Click on Network Activate

To update the plugin in single sites of the WordPress Network follow this procedure:

  1. Visit the specific site of the WordPress Network where you want to update the plugin
  2. Visit the Plugins menu
  3. Click on Deactivate
  4. Update the plugin files with your favorite FTP client (skip this step if you have already updated the plugin files during the plugin update of another single site of the WordPress Network)
  5. Click on Activate

F) Create an Event

To create an Event follow this procedure:

  1. Visit the Live Events -> Events menu
  2. Enter the Name of the Event
  3. Enter the Description of the Event
  4. With the Live option select "Yes" if you want to automatically update the data of the Event, or "No" if you want to generate a static Event
  5. Click the Add Event button

G) Create a Timeline Section

To create a Timeline Section follow this procedure:

  1. Visit the Live Events -> Timeline Sections menu
  2. Select the Event that includes the Timeline Section
  3. Enter the Name of the Timeline Section
  4. Enter the Description of the Timeline Section
  5. Enter the Label of the Timeline Section
  6. With the Show Icon option select if you want to display icons associated with the Timeline Items
  7. With the Time Mode option select if you want to manually enter or automatically generate the time of the Timeline Items
  8. With the Index option you can determine the position of this Timeline Section in the tabs of the Event
  9. Click the Add Timeline Section button

H) Create a Timeline Item

To create a Timeline Item follow this procedure:

  1. Visit the Live Events -> Timeline Items menu
  2. Select the Timeline Section that includes the Timeline Item
  3. With the Extra option select None
  4. Enter a Time for the Timeline Item
  5. Enter a Title for the Timeline Item
  6. Enter the Content of the Timeline Item
  7. Click the Add Timeline Item button

I) Create a Timeline Item with an Image

To create a Timeline Item with an Image follow this procedure:

  1. Visit the Live Events -> Timeline Items menu
  2. Select the Timeline Section that includes the Timeline Item
  3. With the Extra option select Image
  4. Enter a Time for the Timeline Item
  5. Enter a Title for the Timeline Item
  6. Enter the Content of the Timeline Item
  7. Select an Image
  8. Click the Add Timeline Item button

J) Create a Timeline Item with a Tweet

To create a Timeline Item with a Tweet follow this procedure:

  1. Visit the Live Events -> Timeline Items menu
  2. Select the Timeline Section that includes the Timeline Item
  3. With the Extra option select Tweet
  4. Enter a Time for the Timeline Item
  5. Enter a Title for the Timeline Item
  6. Enter the Content of the Timeline Item
  7. In the Tweet field enter the Tweet ID, the Tweet URL, or the Tweet Embed Code
  8. Click the Add Timeline Item button

K) Create a Timeline Item with custom HTML

To create a Timeline Item with custom HTML follow this procedure:

  1. Visit the Live Events -> Timeline Items menu
  2. Select the Timeline Section that includes the Timeline Item
  3. With the Extra option select HTML
  4. Enter a Time for the Timeline Item
  5. Enter a Title for the Timeline Item
  6. Enter the Content of the Timeline Item
  7. In the HTML filed enter your custom HTML (this field can be used to include elements such as YouTube videos, Instagram posts, advertising, iframes and more)
  8. Click the Add Timeline Item button

L) Create and use Timeline Icons

To create and use Timeline Icons follow this procedure:

  1. Visit the Live Events -> Timeline Icons menu
  2. Enter the Name of the Timeline Icon
  3. Enter the Description of the Timeline Icon
  4. Select an Image
  5. Click the Add Timeline Icon button
  6. Visit the Live Events -> Timeline Sections menu and enable the use of Timeline Icons associated with Timeline Items with the Show Icon option
  7. In the Live Events -> Timeline Items menu with the Icon option you can now associate Timeline Icons with Timeline Items

M) Create a Stat Section

To create a Stat Section follow this procedure:

  1. Visit the Live Events -> Stat Sections menu
  2. Select the Event that includes the Stat Section
  3. Enter the Name of the Stat Section
  4. Enter the Description of the Stat Section
  5. Enter the Label of the Stat Section
  6. With the Index option you can determine the position of this Stat Section in the tabs of the Event
  7. Click the Add Stat Section button

N) Create a Stat Group

To create a Stat Group follow this procedure:

  1. Visit the Live Events -> Stat Groups menu
  2. Select the Stat Section that includes the Stat Group
  3. Enter the Name of the Stat Group
  4. Enter the Description of the Stat Group
  5. Enter the Label of the Stat Group
  6. With the Index option you can determine the position of this Stat Group in the Stat Section
  7. Click the Add Stat Group button

O) Create a Single Data Stat Item

To create a Single Data Stat Item follow this procedure:

  1. Visit the Live Events -> Stat Items menu
  2. Select the Stat Group that includes the Stat Item
  3. With the Type option select Single Data
  4. Enter the Subject of the Stat Item
  5. Enter the Value 1 of the Stat Item
  6. With the Percentage option select if the percentage symbol should be displayed
  7. With the Index option you can determine the position of this Stat Item in the Stat Group
  8. Click the Add Stat Item button

P) Create a Single Visual Stat Item

To create a Single Visual Stat Item follow this procedure:

  1. Visit the Live Events -> Stat Items menu
  2. Select the Stat Group that includes the Stat Item
  3. With the Type option select Single Visual
  4. Enter the Subject of the Stat Item
  5. Enter the Value 1 of the Stat Item
  6. With the Percentage option select if the percentage symbol should be displayed
  7. With the Index option you can determine the position of this Stat Item in the Stat Group
  8. Click the Add Stat Item button

Q) Create a Comparison Data Stat Item

To create a Comparison Data Stat Item follow this procedure:

  1. Visit the Live Events -> Stat Items menu
  2. Select the Stat Group that includes the Stat Item
  3. With the Type option select Comparison Data
  4. Enter the Subject of the Stat Item
  5. Enter the Value 1 of the Stat Item
  6. Enter the Value 2 of the Stat Item
  7. With the Percentage option select if the percentage symbol should be displayed
  8. With the Index option you can determine the position of this Stat Item in the Stat Group
  9. Click the Add Stat Item button

R) Create a Comparison Visual Stat Item

To create a Comparison Visual Stat Item follow this procedure:

  1. Visit the Live Events -> Stat Items menu
  2. Select the Stat Group that includes the Stat Item
  3. With the Type option select Comparison Visual
  4. Enter the Subject of the Stat Item
  5. Enter the Value 1 of the Stat Item
  6. Enter the Value 2 of the Stat Item
  7. With the Percentage option select if the percentage symbol should be displayed
  8. With the Index option you can determine the position of this Stat Item in the Stat Group
  9. Click the Add Stat Item button

S) Create a Comment Section

To create a Comment Section follow this procedure:

  1. Visit the Live Events -> Comment Sections menu
  2. Select the Event that includes the Comment Section
  3. Enter the Name of the Comment Section
  4. Enter the Description of the Comment Section
  5. Enter the Label of the Comment Section
  6. With Closed select whether to suppress or not the ability to add new comments
  7. With Avatar select whether to display or not the avatar of the user
  8. With the Index option you can determine the position of this Comment Section in the tabs of the event
  9. Click the Add Comment Section button

T) Create a Comment Item

To create a Comment Item follow this procedure:

  1. Visit the Live Events -> Comment Items menu
  2. Select the Author of the Comment Item
  3. Enter the Content of the Comment Item
  4. With Approved select the moderation status of the Comment Item
  5. Click the Add Comment Item button

U) Publish an Event

Please follow this procedure to include an event in a post with the TinyMCE editor:

  1. Edit a post, page or custom post type
  2. Set the editor in Visual mode
  3. Click the Live Events button
  4. Search or select an event with the provided select box
  5. Click the Add Event button

Please follow this procedure to include an event in post with a block:

  1. Edit a post, page or custom post type
  2. Select the Visual Editor mode
  3. Add the Event block
  4. Search or select a game with the provided select box

V) Update a Timeline Section

To update a Timeline Section follow this procedure:

  1. Visit the Live Events -> Events menu
  2. Verify that the Live option of the specific event is set to "Yes"
  3. Visit the Live Events -> Timeline Items menu
  4. Create new Timeline Items

W) Update a Stat Section

To update a Stat Section follow this procedure:

  1. Visit the Live Events -> Events menu
  2. Verify that the Live option of the specific event is set to "Yes"
  3. Visit the Live Events -> Stat Items menu
  4. Update existing Stat Items

X) Update a Comment Section

To update a Comment Section follow this procedure:

  1. Visit the Live Events -> Events menu
  2. Verify that the Live option of the specific event is set to "Yes"
  3. Visit the Live Events -> Comment Items menu
  4. Create or update Comment Items

Y) Credits

This plugin makes use of the following resources:

Z) FAQ

In a live event (an event where the Live Events -> Events -> Live option is set to "Yes") you will be able to perform the following actions:

The following actions will not be allowed:

The following two options allow you to decrease the server load caused by the AJAX requests used to update live an event.

Update Time

 This option determines the time interval expressed in seconds between the AJAX requests sent to the server to retrieve the data of the live event.

Please note that a short time interval generates an high number of HTTP requests and this behavior might not be suitable for a website hosted on a shared server or for a website with high traffic.

Transient Expiration

When a transient is available the responses to the AJAX requests sent to your server will not be generated with expensive queries on your database, but retrieved directly from the transient associated with the specific event.

Set a high value to improve the live event performance and to avoid an excessive load on the server. Set a low value to have frequent updates of the live event data. Set "0" to not use a transient.

For more information about the transients please visit the Transients API page.

The index field available in the Timeline Sections, Stat Sections and Comment Sections should be used to manually order from left to right the tabs available in an event.

If all the sections have the same index the Timeline Sections have the priority over the Stat Sections, and the Stat Sections have the priority over the Comment Sections.

If multiple sections of the same type (for example multiple Timeline Sections) have the same index, the order will be established based on the order on which the Timeline Sections, Stat Sections or Comment Sections have been created.

The index field available in the Stat Groups and Stat Items should be used to manually order how these elements are displayed in the layout of a Stat Section from top to bottom.

If multiple Stat Groups or Stat Items have the same index the order will be established based on the order on which the Stat Groups or Stat Items have been created.

To hide the social section of the event set to "Disabled" the following options available in the Live Events -> Options -> Social tab:

PHP 5.3 and later versions are supported.

WordPress 4.5 and later versions are supported.