=== Display Event Location for The Events Calendar === Contributors: vikings412 Donate Link: https://paypal.me/michaelw13 Tags: events, customization, modern-tribe, override, template Requires at least: 4.6 Tested up to: 5.3.2 Stable tag: 2.1 Requires PHP: 5.6 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html This plugin works with The Events Calendar by Modern Tribe. It changes the popup on the month view to include the event's location within the popup. == Description == This plugin overrides the standard template for the tooltip that is displayed when a user hovers over an event on the month display of The Events Calendar. The name of the event's venue/location that is entered with the event will be displayed under the date and time that the event occurs. The full street address for the location can also be enabled to be displayed directly underneath the name of the venue of the event. The location name and address are pulled in from the events system itself for each individual event. All of the other elements of the template remain unchanged. == Installation == This section describes how to install the plugin and get it working. **From the WordPress Plugin Directory** The official Display Event Location for The Events Calendar WordPress Plugin can be found [here](https://wordpress.org/plugins/display-event-locations-tec/). The plugin can be downloaded and installed right from your Wordpress administration area by going to `Plugins > Add New` and searching for "Display Event Location for The Events Calendar by Weiner" and clicking "Install" and then by clicing the blue "Activate" after the installation has completed. The `.zip` of the Display Event Location for The Events Calendar Wordpress Plugin can be downloarded right from Wordpress.org using the link above. **From the Github Repository** Go to the [releases](https://github.com/mike-weiner/display-event-locations-tec/releases) section of the repository and download the display-event-locations-tec.zip from the most recent release. Once you have downloaded the display-event-locations-tec.zip from the releases section of this repo, from your WordPress administration panel, go to `Plugins > Add New` and click the gray `Upload Plugin` button at the top of the page. Select the display-event-locations-tec.zip file to upload from your machine when prompted. Wordpress will install the plugin. Once the installation is complete, you will be able to activate the plugin and begin using it! Enjoy! If you have any questions or issues please open a [new issue on the Github repository](https://github.com/mike-weiner/display-event-locations-tec/issues) or submit a support ticket on the Wordpress Plugin directory listing for the Display Event Location for The Events Calendar plugin found [here](https://wordpress.org/support/plugin/display-event-locations-tec/). == Frequently Asked Questions == = I have activated the plugin, but the tooltip still looks the same. Why does the tooltip not list the event's location and/or address? = First, make sure that the plugin 'Display Event Locations for The Events Calendar' is enabled in the backend. If you click on an event within the calendar and then click the `< All Events` link to go back to the calendar, the changes should then be reflected. If you still aren't seeing the location displayed within the tooltip, you can also try viewing your calendar in a different browser or try clearing your browser's cache and then viewing your calendar again. If you still cannot figure out why the location is not displaying, feel free to submit a support ticket and we will be more than happy to help you! > TLDR; Sometimes data is cached in your browser. If your tooltip does not change after a page refresh, try clearing your browser's cache. You can also try viewing the calendar on a different device to determine if it is indeed a caching issue. If that does not work, please submit a support ticket. = Does this plugin display anything other than the name of the event's location? = Yes. You can choose to display just the name of the location or the name of the location and the full address of the location underneath. See the [screenshots](https://wordpress.org/plugins/display-event-locations-tec/#screenshots) for all of the different ways you can display information within the tooltip. See the FAQ titled "How do I display the street address underneath the location name within the looptip?" (below) to learn how to enanle the street address within the tooltip. = How do I display the street address underneath the location name within the looptip? = Hover over "Settings" in the left-hand sidebar within the administration area of your Wordpress installation. Click on "Display Event Locations for The Events Calendar" from the flyout that appears. Once the page loads, click the checkbox for the "Show Full Venue Address Inside Tooltip" option. Once the checkbox is selected, click the blue "Save Changes" button. Once the page reloads, scroll to the bottom of the page and under the "Preview Tooltip" area, the fake tooltip should display the location and fake street address underneath. = How do I change the name and/or street address for event locations? = This plugin uses the location/venue name and address that is entered within the [Modern Tribe Event System](https://theeventscalendar.com/product/wordpress-events-calendar/) itself. To chagne the name or street address of an event location/venue hover over `Events` in the admininstration sidebar and select `Venue` from the flyout that appears. Then select the location that you wish to change the name or address of. Once the page loads you will be able to change the name and address. Once you finish making updates, clikc the blue Update button. = What plugins are required for these changes to take effect? = Your website must use The Events Calendar 4.8 or The Events Calendar Pro 4.8 or higher for this plugin to correctly modify the tooltip. = Does this plugin change the tooltip for both regular and featured events? = Yes, this plugin will change the tooltip for both regular and featured events. = Does this plugin work for events created with the block editor? = No. This plugin will NOT modify the tooltip for events created with the the block editor for either the standard or pro versions of _The Events Calendar_. == Screenshots== 1. The settings page for the Display Event Locations for The Events Calendar plugin. This is where you can change what is displayed on your tooltip when a user hovers over an event on your website's calendar. 2. This is what the tooltip for a regular event will look like after activating this plugin with only the location name enabled. 3. This is what the tooltip for a regular event will look like after activating this plugin with the location name and street address enabled. 4. This is what the tooltip for a featured event will look like after activating this plugin with only the location name enabled. 5. This is what the tooltip for a featured event will look like after activating this plugin with the location name and street address enabled. == Changelog == = 2.1 = * Released on January 8, 2020 * Added: The event street address can now be displayed within the tooltip underneath the location name. * Added: Uninstallation Hook (Your settings for this plugin will now be deleted from the wp_ database when you uninstall this plugin.) * Added: An additional line break has been added to featured event tooltips to make things more readable! * Added: Travis CI has been implemented to automatically check for any syntax and compatibility issues with modern and common versions of PHP. * Added: New screenshots of the plugin to show the new feature of being able to add the street address to the tooltip. * Edited: /includes/settings-page/settings-page.php * Edited: /includes/settings-page/settings-register.php * Edited: /includes/settings-page/settings-callbacks.php * Edited: /includes/settings-page/settings-validate.php * Edited: /tribe/events/month/tooltip.php * Edited: /tribe/events/month/pro/tooltip.php * Edited: /tribe-events/month/tooltip.php * Edited: /tribe-events/month/pro/tooltip.php * Edited: /assets/screenshot1.png * Edited: /assets/screenshot2.png * Edited: /assets/screenshot3.png * Edited: /assets/screenshot4.png * Edited: /assets/screenshot5.png * Edited: plugin.php * Edited: README.md * Tested: Support up to WordPress 5.2.3 has been tested and confirmed * Tested: Support up to PHP 7.4 has been tested and confirmed * Tested: Minimum PHP Version is now set at 5.6 = 2.0.1 = * Released on September 5, 2019 * Added: Support for WordPress 5.2.3 has been tested and confirmed = 2.0 = * Released on July 8, 2019 * Added: Settings page titled "Display Event Locations for The Events Calendar" has been added as as sub-menu page under the "Setting" section in the backend * Added: /includes/ * Added: /includes/settings-page/admin-menu.php * Added: /includes/settings-page/settings-page.php * Added: /includes/settings-page/settings-register.php * Added: /includes/settings-page/settings-callbacks.php * Added: /includes/settings-page/settings-validate.php * Added: Preview of the tooltip text can be found on the settings page * Added: All setting fields are sanitized before being added to an array that is saved in the wp_ database * Added: Saved settings & options are now removed from your database upon the uninstalling of the Display Event Locations for The Event Calendar Plugin * Added: Quick links to our settings page & support page can be found within our plugin listing on the Plugins page. * Tested: Support for Wordpress 5.2.2+ * Tested: Support for The Events Calendar 4.9.4+ * Tested: Support for PHP 7.0+ * Fixed: Unneeded HTML has been removed from all tooltip.php files * Fixed: All typos in commenting of the code have been removed = 1.1 = * Released on May 12, 2019 * FIXED - Deactivation/Reactivation Bug * IMPLEMENTED - tribe_events_template_data_array() Hook * MISC. - All single-event.php Override Files Removed = 1.0.1 = * FIXED - Adjusted readme.txt to display screenshots * CHANGED - Changed CSS Class from 'tribe-events-location' to 'deltec-tribe-events-location' * MISC. - Added Plugin Logo Assets = 1.0 = * Released on April 29, 2019 * Initial release == Upgrade Notice == = 2.1 = Happy New Year!! Version 2.1 is a small, powerful update to welcome the new decade. You can now opt to display an event's location underneath the location name within the tooltip! Support for WordPress 5.2.3 has also been added. = 2.0.1 = Version 2.0.1 is a very minor update. Support with WordPress 5.2.3 has been tested and confirmed. Thank you for your support! = 2.0 = Version 2.0 is a major quality of life overhaul. There are too many small changes here and there to cover. Let me give you a quick-ish overview. You can now quickly change the message that is displayed on the tooltip when a user hovers over an event on your website's calendar. This is done through the Display Event Locations for The Events Calendar settings page. You can find this within the Settings area of your site's backend as a sub-menu page of the Settings dropdown/flyout. Unneeded code & increased security measures have been implemented. All of our saved settings are now removed upon you uninstalling our plugin from your website. I have also done extensive testing with the latest versions of WordPress and The Events Calendar. All human typos have also been dealt with. Thank you for sticking with me! You should notice lots of little improvements as you use the plugin. Please let me know what features you would like to see next! = 1.1 = Version 1.1 addresses and fixes the need to deactivate and then reactivate the Modern Tribe Events System plugin. Feel free to activate our plugin and go about your business. = 1.0.1 = Fixed typos in readme.txt. Added Logos. Changed CSS Class from `tribe-events-location` to `deltec-tribe-events-location`. = 1.0 = Initial release! == Arbitrary section == === CSS Classes: === * `deltec-tribe-events-location` - Within the tooltip/popup the text 'Location: Event-Location-Here' and street address (if enabled) is wrapped in this class. Use this to style the additional information added to the popup. === Github Repository === * The Github Repository can be found [here](https://github.com/mike-weiner/display-event-locations-tec). === References: === Below are resources and references that were used to help develop parts of this plugin. 1. [https://theeventscalendar.com/support/forums/topic/altering-event-tooltip-display-displaying-additional-fields-in-tooltips/](https://theeventscalendar.com/support/forums/topic/altering-event-tooltip-display-displaying-additional-fields-in-tooltips/) 2. [https://theeventscalendar.com/support/forums/topic/override-templates-via-custom-plugin/](https://theeventscalendar.com/support/forums/topic/override-templates-via-custom-plugin/) 3. [https://support.theeventscalendar.com/153124-Themers-Guide](https://support.theeventscalendar.com/153124-Themers-Guide)