=== 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.4.1 Stable tag: 3.2 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 template for the tooltip that is displayed when a user hovers over an event on the month display of The Events Calendar and The Events Calendar Pro. 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 venue/location name and address are pulled in from the events system itself for each individual event. All of the other elements of the tooltip remain unchanged. [The Events Calendar](https://theeventscalendar.com/product/wordpress-events-calendar/) and [The Events Calendar Pro](https://theeventscalendar.com/product/wordpress-events-calendar-pro/) are WordPress plugins developed by [Modern Tribe](https://tri.be). == Installation == This section describes how to install the plugin and activate it on your WordPress installation. ### From the WordPress Plugin Directory The official Display Event Location for The Events Calendar WordPress Plugin can be found at: [https://wordpress.org/plugins/display-event-locations-tec/](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 clicking the blue "Activate" after the installation has completed. ### 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 `wordpress-display-event-locations-tec.zip` from the most recent release. Once you have downloaded the `wordpress-display-event-locations-tec.zip` from the releases section of this repo sign into the backend of your WordPress website. 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 `wordpress-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](https://wordpress.org/support/plugin/display-event-locations-tec/) on the WordPress Plugin directory listing for the Display Event Location for The Events Calendar plugin. == 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 Location for The Events Calendar' is installed and activated. To check this, click on the `Plugins` option from the left-hand administration sidebar in WordPress. Once the page loads, make sure "Display Event Location for The Events Calendar" is activated. If the plugin is active and the changes to the tooltip are still not present, try updating an existing event or creating a new test event. Save and publish the event. Then, take a peak at your calendar on the front-end of your website. The changes to the tooltip should now 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 a small change is difficult. Give it a few minutes, and if you get frustrated we are here to help you! [Submit a support ticket](https://wordpress.org/support/plugin/display-event-locations-tec/) on Wordpress.org or [open a new issue](https://github.com/mike-weiner/display-event-locations-tec/issues) on the Github repository and we'll help get you up and running! :) = 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 the location name. 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 tooltip?" (below) to learn how to enable the street address within the tooltip. = How do I change the phrase "Location: " that is displayed before the name of an event's venue/location within the tooltip? = Hover over `Settings` in the left-hand sidebar within the administration area of your WordPress website. Click on `Display Event Location for The Events Calendar` from the flyout that appears. Once the page loads, click the edit the text within the `Tooltip Message Before Venue/Location Name` textbox. Once the you have edited the message to what you would like, 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 your custom message before the event's venue/location name. = How do I remove the phrase "Location: " that is displayed before the name of an event's venue/location within the tooltip so nothing is displayed before the event venue/location name? = Hover over `Settings` in the left-hand sidebar within the administration area of your WordPress website. Click on `Display Event Location for The Events Calendar` from the flyout that appears. Once the page loads, remove the text within the `Tooltip Message Before Venue/Location Name` textbox. Once the you have removed all of the text in the box, 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 no custom message before the event's venue/location name. = 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 Location 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 font size of the event venue/location name and/or street address text within the tooltip? = In version 3.2 of this plugin, a robust CSS class system was implemented to allow for greater control of the stylization of the elements added to the tooltip by this plugin. To change the font-size of the venue/location name and street address add the CSS code below to your website. `.deltec-tooltip-message { font-size: 14px; }` **Note:** This CSS is very basic and is just meant as a starting point. It could be overwritten by a more specific CSS call. Please see the [Arbitrary Section](https://wordpress.org/plugins/display-event-locations-tec/) on the WordPress Repository page or on the [Github Repository README](https://github.com/mike-weiner/display-event-locations-tec#css-classes). = 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 change the name or street address of an event location/venue hover over `Events` in the administration 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, click 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. If you wish to use the v2 calendar layouts, you much use The Events Calendar 5.0+ or The Events Calendar Pro 5.0+. = Does this plugin change the tooltip for both regular and featured events? = Yes! This will plugin will display the event venue name and location (if you have enabled the address to be displayed) for both regular and featured events! See the [screenshots](https://wordpress.org/plugins/display-event-locations-tec/#screenshots) to see how this would look! = Will this plugin work on both the legacy and v2 calendar views? = Yes! This plugin modifies both the old calendar views (legacy) and the new calendar views (v2) introduced with The Events Calendar 5.0 and The Events Calendar Pro 5.0. = Does this plugin work for events created with the block editor? = Yes! This plugin will modify the tooltip for events created with the the block editor for both the standard or pro versions of `The Events Calendar` or `The Events Calendar Pro`. = I am having issues with the tooltip not showing the venue name and/or address with events created with the block editor. Why? = As great as the block editor is it can cause issues, sometimes. For events that you create with the block editor, make sure a venue or location is set for each event! Sometimes locations are removed from the event. If any issues persist, [let us know](https://wordpress.org/support/plugin/display-event-locations-tec/) and we will take a look under the hood! == Screenshots== 1. The settings page for the Display Event Location 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. Notice the preview for what the tooltip will display at the bottom of this page. 2. This is what the tooltip for a regular event will look like after activating this plugin with only the location name enabled with the v2 calendar template. 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 with the v2 calendar template. 4. This is what the tooltip for a featured event will look like after activating this plugin with only the location name enabled with the v2 calendar template. 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 with the v2 calendar template. 6. This is what the tooltip for a regular event will look like after activating this plugin with only the location name enabled with the legacy calendar template. 7. This is what the tooltip for a regular event will look like after activating this plugin with the location name and street address enabled with the legacy calendar template. 8. This is what the tooltip for a featured event will look like after activating this plugin with only the location name enabled with the legacy calendar template. 9. This is what the tooltip for a featured event will look like after activating this plugin with the location name and street address enabled with the legacy calendar template. == Changelog == = 3.2 = * Released on May 13, 2020 * Added: Stable tag updated to 3.2 * Added: Tested up to tag changed to 5.4.1 as support with WordPress 5.4.1 has been confirmed * Added: New CSS class system for the information that is added to the tooltip by the plugin to allow for greater control. New CSS classes for use are: `.deltec-tooltip-message`, `.deltec-location-name-prefix`, `.deltec-location-name`, and `.deltec-street-address`. See the [Arbitrary Section on CSS Classes](https://github.com/mike-weiner/display-event-locations-tec#css-classes) on the Github Repository README for more information * Fixed: Fixed typos within README * Removed: Old CSS class `.deltec-tribe-events-location` has been removed in place of the new robust CSS class system to allow for greater control of the stylization of the location information within tooltip (See Above) * Removed: Excess comments have been removed from the template override files for the tooltip * Edited: plugin.php * Edited: README.md * Edited: /tribe/events/month/calendar-body/day/calendar-events/calendar-event/tooltip/title.php * Edited: /tribe-events/month/tooltip.php = 3.1 = * Released on March 7, 2020 * Added: Support with WordPress 5.4 has been tested and confirmed * Added: An error message will be displayed for administrators on the plugin page if The Events Calendar plugin is not activated * Added: All functions within plugin.php have been alphabetized * Added: FAQ Question "How do I remove the phrase "Location: " that is displayed before the name of an event's venue/location within the tooltip so nothing is displayed before the event venue/location name?" has been added * Added: FAQ Question: "How do I change the font size of the event venue/location name and/or street address text within the tooltip?" has been added * Fixed: All excess function header comment information has been removed * Fixed: Fixed typo on Display Event Location for The Events Calendar settings page and within the menu sidebar * Fixed: Replaced screenshot-1 with an updated version to reflect removal of typo in settings page title * Edited: plugin.php * Edited: README.md * Edited: /assets/screenshot1.png * Edited: /includes/settings-page/admin-page.php * 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/calendar-body/day/calendar-events/calendar-event/tooltip/title.php * Edited: /tribe-events/month/tooltip.php = 3.0.2 = * Released on February 8, 2020 * Fixed: Fixed inconsistencies in the plugin name within the files headers. * Fixed: Removed unintended logic from plugin.php that used tribe_events_views_v2_is_enabled(). * Updated: The description of this plugin has been updated to reflect new features. * Edited: plugin.php * Edited: README.md * Edited: /includes/settings-page/admin-page.php * Edited: /includes/settings-page/settings-page.php * Edited: /includes/settings-page/settings-callbacks.php = 3.0.1 = * Released on February 7, 2020 * Fixed: Fixed the file path for the currently active theme within deltec_tribe_custom_template_paths_v2_views(). This will allow TEC to look into your active theme directory (correctly) to grab any additional template overrides after it has pulled the templates from our plugin in. * Edited: plugin.php * Edited: README.md = 3.0 = * Released on February 7, 2020 * Added: Support for overriding the tooltip on the new v2 calendar views has been added. (This allows you to display the venue/location name and address (if you have enabled it) within the tooltip.) * Added: 9 new screenshots (screenshots 1-9) have been added to the WordPress Plugin listing page to reflect what the tooltip in the legacy and v2 calendar views with the location and/or address displayed for an event. * Added: This plugin will now allow for template overrides that you already have in your active theme folder. It will first use the templates within our plugin and will then check your active theme directory for any additional templates. * Added: All functions and files have been documented and typos have been removed (please, let us know if you find any others). * Fixed: Fixed a bug that prevented tooltip from displaying for events that did not have an venue/location set. * Fixed: Tooltip preview on "Display Event Location for The Events Calendar" settings page has been updated to reflect new street address formatting. * Fixed: Fixed 'Undefined Index' notice for the 'display-full-address' option through the WP Settings API * Fixed: Fixed 'Illegal String Offset' Warning on Settings Callback * Fixed: Removed excess HTML from tooltip.php located at /tribe-events/month/tooltip.php * Edited: plugin.php * Edited: README.md * Edited: /assets/screenshot1.png * Edited: /assets/screenshot2.png * Edited: /assets/screenshot3.png * Edited: /assets/screenshot4.png * Edited: /assets/screenshot5.png * Edited: /assets/screenshot6.png * Edited: /assets/screenshot7.png * Edited: /assets/screenshot8.png * Edited: /assets/screenshot9.png * Edited: /includes/settings-page/admin-page.php * 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/calendar-body/day/calendar-events/calendar-event/tooltip/title.php * Edited: /tribe-events/month/tooltip.php = 2.2 = * Released on January 13, 2020 * Added: All code has been cleaned and documented! Rejoice! * Added: All function and variable names now use the global plugin prefix: $deltec_ * Added: Tooltip overrides for events created with the block editor has been re-enabled. * Added: deltec_get_tec_plugin_version() has been added to get the version of the current version of The Events Calendar or The Events Calendar Pro that is installed and activated in preparation for The Events Calendar version 5.0! * Notice: Modern Tribe has announced that version 5.0 will be released sometime this month (it is nearing the end of its beta!). We are working to get support for version 5.0 ready for launch. Please be aware that if you update to version 5.0 your tooltip will not be the same as the new version brings an entirely new look! We will work to get support for version 5.0 out ASAP! Keep your eye out for an update. * Edited: /includes/settings-page/admin-page.php * 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: plugin.php * Edited: README.md * Removed: /tribe/events/month/tooltip.php * Removed: /tribe/events/month/pro/tooltip.php * Removed: /tribe-events/month/pro/tooltip.php = 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 == = 3.2 = Today's update brings a revamp of the CSS class structure for all information that this plugin adds to the tooltip in your monthly view! You can now control the stylization of all of the individual components that can be added to the tooltip to display your event's location and its street address (if enabled). You can find more detailed information about the new CSS class structure in the Arbitrary section on CSS Classes of the Github Repository[README](https://github.com/mike-weiner/display-event-locations-tec#css-classes). Support for WordPress 5.4.1 has also been confirmed in testing. As always, please let us know if you experience any issues! = 3.1 = Happy Saturday! Lots of small things are in the works -- Support for WordPress 5.4 that is slated to be released at the end of March has been tested and confirmed. A new admin error message will now be displayed if The Events Calendar is not activated when Display Event Location for The Events Calendar is active. Other small source code spring cleaning has ocurred (See the changelog for more details.). As always, thank you for the support and let us know if you encounter any issues! = 3.0.2 = More quick updates are on the horizon! Code has been cleaned and further simplified, and plugin names have been made consistent. Please let us know if you experience any issues! = 3.0.2 = More quick updates are on the horizon! Code has been cleaned and further simplified, and plugin names have been made consistent. Please let us know if you experience any issues! = 3.0.1 = A quick bug fix has been deployed to make sure TEC looks into the correct directory within your active theme to be able to pull in any additional template overrides. Have a great weekend! = 3.0 = Support for the beautiful v2 calendar views introduced with The Events Calendar 5.0 is here! This update not only adds support for the new tooltip within the v2 calendar views, but it also fixes a handful of bugs, adds greater code documentation, and addresses several quality-of-life issues with the plugin. As usual, please let us know if you run into any issues! where there's a will there's a way, the deltec dev team. = 2.2 = A second update in a week? Yessir! Code has been cleaned and documented. Support for tooltip customizations for events created with the block editor has been restored. Excess files have been removed. (Post holiday workout anyone?) And we are preparing for The Events Claendar version 5.0! A busy couple of weeks ahead! = 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-tooltip-message` - A `div` or `paragraph` element that surrounds all of the information that is added to the tooltip by this plugin. **Note:** For the new calendar views in The Events Calendar v5.0+ this class is defined by a paragraph element. For the older calendar views, this class is represented by a div element. * `.deltec-location-name-prefix` - A `span` element that surrounds the prefix message that you can set in the Display Event Location for The Events Calendar settings area in the textfield labeled ***Tooltip Message Before Venue/Location Name*** * `.deltec-location-name` - A `span` element that surrounds the name of the event's venue/location name. * `.deltec-street-address` - A `span` element that surrounds the all elements of the street addressed for the event's venue/location (if enabled in Display Event Location for The Events Calendar settings area) === 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://support.theeventscalendar.com/153124-Themers-Guide](https://support.theeventscalendar.com/153124-Themers-Guide) 2. [https://docs.theeventscalendar.com/reference/hooks/tribe_events_template_data_array/](https://docs.theeventscalendar.com/reference/hooks/tribe_events_template_data_array/) 3. [https://docs.theeventscalendar.com/reference/hooks/tribe_template_theme_path_list/](https://docs.theeventscalendar.com/reference/hooks/tribe_template_theme_path_list/) 4. [https://docs.theeventscalendar.com/reference/functions/tribe_address_exists/](https://docs.theeventscalendar.com/reference/functions/tribe_address_exists/) 5. [https://docs.theeventscalendar.com/reference/functions/tribe_get_full_address/](https://docs.theeventscalendar.com/reference/functions/tribe_get_full_address/) 6. [https://theeventscalendar.com/knowledgebase/k/custom-additional-template-locations/](https://theeventscalendar.com/knowledgebase/k/custom-additional-template-locations/) 7. [https://gist.github.com/cliffordp/b76421f2490a8b8995493f203e11b331](https://gist.github.com/cliffordp/b76421f2490a8b8995493f203e11b331) === Special Thanks: === A special thank you to user [@cliffordp](https://github.com/cliffordp) on Github for several helpful gists that were used as boilerplates achieve certain functionality within this plugin.