TK Event Weather
| 开发者 | cliffpaulick |
|---|---|
| 更新时间 | 2020年12月22日 02:58 |
| PHP版本: | 5.6 及以上 |
| WordPress版本: | 5.6 |
| 版权: | GPL version 3 or any later version |
| 版权网址: | 版权信息 |
详情介绍:
Display beautiful, accurate, and free hourly weather forecasts between a start and end time on the same day. Perfect for event calendars. Includes sunrise, sunset, temperature, wind speed and direction, and is very customizable.
https://www.youtube.com/watch?v=KXyWZrfgL4k
https://www.youtube.com/watch?v=fbGS_LtX-es
Highlights
- Registers the
[tk_event_weather]shortcode for use anywhere on your site (not just for your site calendar's event-specific information) so its usage is very flexible as long as there is a valid weather API key, latitude, longitude, and time (timestamp or ISO 8601 format) - Uses the Dark Sky API to provide you with an accurate, reliable (typically 99.9% uptime), and free (or low cost if over the daily free API calls limit) weather forecast
- Uses WordPress' Transients API to minimize external API calls (i.e. does not call the APIs on every page load) to increase page load time and save you money (or keep you from hitting the free limits)
- Returns temperature (fahrenheit or celsius) in units local to the given latitude and longitude (with option to force display in either unit of measure)
- Internationalized / translatable (translations not provided)
- No WP_DEBUG messages
- Optimized asset loading and API calls
- Actions and filters available for developers to support advanced customizations
- Responsive plugin developer
- The Events Calendar by Modern Tribe - 800,000+ active installs - Purchase
- Events Manager by Marcus Sykes - 100,000+ active installs - Purchase
- Simple Calendar by Moonstone Media - 80,000+ active installs - Purchase
- All-in-One Event Calendar by Timely - 100,000+ active installs
- Event Organiser by Stephen Harris - 30,000+ active installs
- My Calendar by Joe Dolson - 30,000+ active installs
- EventOn by ashanjay - 51,000+ sales
- Bookly Booking Plugin by Ladela - 31,000+ sales
- WP Simple Booking Calendar by simplebookingcalendar - 10,000+ active installs and/or its Premium version
- Calendarize it! by RightHere - 11,000+ sales
- Timetable Responsive Schedule For WordPress by QuanticaLabs - 9,000+ sales
- Wordpress Pro Event Calendar by DPereyra - 6,700+ sales
- Event Booking Pro by MoeHaydar - 5,000+ active installs
- Booked - Appointment Booking for WordPress by BoxyStudio - 11,000+ active installs
- Events Calendar Registration & Booking by elbisnero - 6,000+ sales
- Event Espresso - 2,000+ active installs of EE4 Decaf and/or its paid version
- Sugar Events Calendar Lite by Pippin Williamson - 1,000+ active installs
- Team Booking by VonStroheim - 5,500+ sales
- HBook - Hotel booking system by HotelWP - 6,000+ sales
- Modern Events Calendar by WEBNUS - 60,000+ active installs, previously on CodeCanyon
- FooEvents for WooCommerce - 3,500+ sales
- WP Booking Calendar by Wachipi - 2,000+ sales
- WooCommerce Bookings - thousands of active installs (exact number unknown)
- WooCommerce Appointments by BizzThemes
- Booking & Appointment Plugin for WooCommerce by Tyche Softwares
- BirchPress Scheduler
- Geolocate user to display weather for user's current location (i.e. no specific latitude or longitude shortcode arguments)
- Styling (custom colors, possibly custom icons)
- Advanced templates/views
- You'll need to register for a free Dark Sky API key
- Quote from Dark Sky's website, as of March 31, 2020:
- Our API service for existing customers is not changing today, but we will no longer accept new signups. The API will continue to function through the end of 2021.
- We're planning to eventually implement ClimaCell as a weather provider replacement, which is very comparable to the Dark Sky service.
- If you're out of API calls for the day and you haven't entered billing information, the plugin will "fail gracefully" (does not display errors to non-Administrators).
- This plugin and its author are not affiliated with or endorsed by The Dark Sky Company, LLC, ClimaCell, Inc., or any of the other plugins mentioned (including ones for which an add-on is available).
- This plugin utilizes Freemius. All data collected via Freemius will be available to both Freemius and this plugin's author to be used in responsible ways. By opting-in to Freemius, you'll help us learn how we can make this plugin better and possibly communicate with you regarding the plugin's development.
- This plugin's description and code may contain affiliate links.
- Leave a great review
- Buy one of my available paid add-ons or tell me about one you'd be interested in purchasing!
- View my other plugins
- Hire Me for Custom Integrations and other Customizations
- Contribute code via GitHub
- Assist with translations via WordPress.org -- How to get started
- Tweet this plugin
安装:
After automatically or manually installing to wp-content/plugins/:
- 启用这个插件
- Navigate to this plugin's Settings page (wp-admin > Settings > TK Event Weather)
- Click the "Edit Plugin Settings in WP Customizer" button to enter your Dark Sky API key and setup any other available settings.
- Then use the shortcode however you wish throughout your site (will require manually entering latitude and longitude) or install one of our add-ons to make it easy to integrate with your event calendar.
屏幕截图:
常见问题:
What shortcodes are available?
[tk_event_weather]
What are some shortcode examples?
- Weather for the White House on February 1, 2016, from 4:30pm–9:45pm Eastern Time:
[tk_event_weather lat_long="38.897676,-77.03653" start_time="2016-02-01T16:30:00-05:00" end_time="2016-02-01T21:45:00-05:00"]
B) or separate shortcode arguments for Latitude and Longitude
[tk_event_weather lat="38.897676" long="-77.03653" start_time="2016-02-01T16:30:00-05:00" end_time="2016-02-01T21:45:00-05:00"]
C) or with Unix timestamps
[tk_event_weather lat_long="38.897676,-77.03653" start_time="1454362200" end_time="1454381100"]
D) Just like Example A but with Location shortcode argument (a Place name) -- available since version 1.2.0
[tk_event_weather location="The White House" start_time="1454362200" end_time="1454381100"]
E) Just like Example D but with Location shortcode argument (a full address) -- available since version 1.2.0
[tk_event_weather location="1600 Pennsylvania Ave NW, Washington, DC 20500, USA" start_time="1454362200" end_time="1454381100"]
F) Displaying more than one day in a sequence (multiple API calls but appear all together), like this screenshot
[tk_event_weather lat_long='28.5549259,-81.3342398' start_time='2016-08-27T22:00:00-04:00' end_time='2016-08-27T23:59:00-04:00' class='tkeventw-myclass'] [tk_event_weather lat_long='28.5549259,-81.3342398' start_time='2016-08-28T00:00:00-04:00' end_time='2016-08-28T04:30:00-04:00' class='tkeventw-myclass' darksky_credit_link_off='true']
And then add some custom CSS, like this:
.tkeventw-myclass { display: inline-block; vertical-align: top; }
G) To display from 4:30pm through the remainder of the day (do not set the end_time)
[tk_event_weather lat_long="38.897676,-77.03653" start_time="2016-02-01T16:30:00-05:00"]
H) To display only 4:00pm's weather, set end_time to the same
[tk_event_weather lat_long="38.897676,-77.03653" start_time="2016-02-01T16:00:00-05:00" end_time="2016-02-01T16:00:00-05:00" sunrise_sunset_off="true"]
I) To display Today's weather from 6am - 7pm, begin the start_time and end_time shortcode arguments at the "T" part of the ISO 8601 format. Note that you will likely need to edit the shortcode twice per year to accurately reflect the location's Daylight Savings Time (DST) UTC offset.
[tk_event_weather location="The White House" start_time=T06:00:00-0400 end_time=T19:00:00-04:00 before="Today's Forecast"]
J) To display the weather from right now through the next 3 hours. NOTE: end_time is relative to start_time, not to "now" (unless start_time is set to "now").
[tk_event_weather location="The White House" start_time="now" end_time="+3 hours"]
Example: At 12:06pm, this shortcode will display 12pm, 1pm, 2pm, 3pm, and 4pm (5 hours, possibly more if sunrise or sunset) -- because the shortcode always "bookends" the hours -- so it rounds 12:06pm down to 12:00 and rounds 3:06pm up to 4:00pm. So if you'd like only 12pm, 1pm, and 2pm to be displayed, you could add class="max-3" to the shortcode and then also add this CSS:
.tk-event-weather__wrapper.max-3 .template-hourly_horizontal__item:nth-of-type(1n+4) { display: none; }
Will this plugin work with my theme?
This plugin will work with any properly-coded WordPress theme. Free styling / customization help to integrate with your theme is not available from the plugin author.
What system specs are required?
This plugin requires WordPress version 4.3.0 or later. It is always recommended to use the latest version of WordPress for compatibility, performance, and security reasons. This plugin may not work properly with PHP versions earlier than 5.6. You should meet or exceed the WordPress recommended software specs for best performance and security. Any of this plugin's add-ons for specific event calendars would require the latest version of each add-on plugin and each event calendar plugin.
How accurate are the forecasts?
Basically, accuracy is a high priority. Here are quotes from the Dark Sky API docs:
- "The Dark Sky API is backed by a wide range of data sources, which are aggregated together to provide the most accurate forecast possible for a given location."
- "Most of our sources focus on the USA and UK, and these areas are best supported by our API. We have plans to greatly improve our international forecasts in the near future."
Acknowledgements
Many thanks to the following:
更新日志:
- Changelog DIFFs for all versions are available at GitHub:
https://github.com/cliffordp/tk-event-weather/compare/X.X.X...Y.Y.Y(older version ... newer version) - Freemius' changelog is available at GitHub
- December 21, 2020
- Tested up to WordPress 5.6
- Update Freemius SDK from v2.4.0.1 to v2.4.1
- August 3, 2020
- Tested up to WordPress 5.5
- Update Freemius SDK from v2.3.2 to v2.4.0.1
- July 24, 2020
- Tested up to WordPress 5.4.2
- Fixed WordPress.org SVN release missing CSS and JS assets (props to @shawfactor for reporting).
- April 6, 2020
- Tested up to WordPress 5.4
- Fixed admin embed of Google Maps manual geocoder (in the Settings' "Tools" tab), since they relocated it.
- January 8, 2020
- Tested up to WordPress 5.3.2
- Updated date display for WordPress 5.3's new wp_date() function in a backwards compatible way
- Updated Freemius SDK to v2.3.2
- Moved Freemius submenu options to tabs within main plugin options to reduce clutter Before-After screenshot
- Fix
icon.svgat Freemius setup prompt - Set empty values for missing properties to avoid undefined property errors in template files
- August 4, 2019
- Tested with WordPress 5.2.2
- Updated Freemius SDK from v2.2.4 to v2.3.0
- Google geocoder in admin's "Tools" tab now loads on HTTPS
- March 5, 2019
- Tested with WordPress 5.1
- Now requires PHP version 5.6 or greater.
- Now may disable upsells by adding
define( 'TK_EVENT_WEATHER_DISABLE_UPSELLS', true );towp-config.php - Updated Freemius SDK from v1.2.3 to v2.2.4 (security fix).
- December 31, 2017
- Now requires WordPress version 4.6 or greater, for the sake of translate.wordpress.org
- Multi-day: Any shortcode that tries to span more days than the limit will no longer result in an error. Instead, it will just display the "limit" number of days.
- Shortcode's asset(s) now load on every page load (instead of just when the shortcode is present) to support Ajax-based themes and page transitions as well as simplifying logic within some add-ons. In general, this should not negatively affect overall page load time and may actually improve initial load time of some pages.
- Added a "Settings" quick action link on the wp-admin Plugins List page.
- Added display of a wp-admin notice if you have a plugin for which there is an integration add-on but do not have the add-on installed. It only displays on the Plugins List page and the TK Event Weather settings page.
- Applied
esc_attr()to thecustom_contextshortcode argument, and, if it is used, it gets added to the wrapper class. - Fixed display of add-ons' options on the Help tab report.
- Fix one shortcode's error to not display for following shortcodes on the same page.
- Updated Freemius SDK from v1.2.2.9 to v1.2.3
- November 28, 2017
- Fixed display of Hourly Vertical with Columns when Before Text is present.
- Cleaned up the Before and After text logic and corrected these filter names:
tk_event_weather_before_full_htmltotk_event_weather_text_beforeandtk_event_weather_after_full_htmltotk_event_weather_text_after.
- November 27, 2017
- Better loading logic for Freemius, which is especially important if using any add-ons.
- November 21, 2017
- Version bump for issues with .org upload of version 1.5.0
- Tweaks for uninstalling via Freemius' best practices.
- November 21, 2017
- Over 100 development hours since the last release! Enjoy the fruits of my labor and, if you're using this alongside a calendar plugin, please consider purchasing (or requesting) its paid add-on to help me and make your life easier! :) Enhancements:
- Added support for forecasting across multiple days. To avoid accidental excess usage of API credits (each day's weather costs 1 API credit), the multi-day limit per shortcode is limited to 10 by default, customizable from 1 to as many as you want. Any shortcode that tries to span more days than the limit will result in an error with helpful tips to adjust the shortcode.
- Multi-day forecasts will trim days from the beginning only if Today is in the span of days. This can be disabled in the plugin settings.
- Added "vertical columns" mode option for displaying multiple days adjascent using CSS Flexbox.
- Displays the name of each day before each day's output. The date format can be set in the plugin settings. Each day's name also has a title attribute (displayed on hover) summarizing the entire day's weather.
- Added Dark Sky's "language" setting to display the summary text(s) in one of the languages supported by Dark Sky.
- Added a convenient link in the WP Admin Bar to edit the current URL in the Customizer, jumping right to TK Event Weather's settings panel. Removed the
tk_event_weather_customizer_link_to_core_sectionfilter, as it is irrelevant now. - Added
tk_event_weather_gmaps_geocode_request_uri_query_argsfilter to allow adding things like Region Biasing. - Each day's Before and After content is generated via the existing template engine, allowing you to override them if desired.
- Whenever viewing today's weather forecast, the day name will be "Today" (a translatable string) instead of something like "Dec 7". This may be disabled either via template override or via a filter hook... but we think it's nifty!
- Each day now has a class of "tk-event-weather__day-type-future" (or instead ending with "today" or "past") to make it easy to style past, today, and future days to your liking.
- Added an option to delete all this plugin's data when this plugin is uninstalled via the wp-admin Plugins settings page.
- Plugin now verifies a sufficient version of WordPress core is running. As of this release, 4.5 is the minimum required version.
- Improved the Customizer UI by breaking out all the plugin options from a single section to multiple sections.
- All capability checks consolidated into one, which defaults to 'customize' but is customizable via the new
tk_event_weather_required_capabilityfilter. - Removed
tk_event_weather_darksky_units_defaultandtk_event_weather_darksky_exclude_defaultfilters. Addedtk_event_weather_dark_sky_request_uri_query_argsfilter. - Combined plugin and Dark Sky credit links into a single line and altered CSS as needed.
- Updated Freemius SDK from v1.2.1.7.1 to v1.2.2.9
- Detect when a Manual UTC Offset (like "UTC+10") is used instead of an IANA timezone name supported by the weather API and PHP (like "Australia/Brisbane"). If a manual UTC offset is used, the shortcode will now result in an error. Previously, it would fallback to use the API's detected local timezone. This change was made to reduce confusion and the possibility of inconsistencies in some edge cases.
- Hourly Horizontal's scrolling CSS no longer affects the Hourly Vertical and Low-High displays.
- May 26, 2017
- Fix - Remove potential for start time timestamp variable not being defined in cases where the start_time shortcode argument value was of an unexpected (and invalid) variety.
- Updated Freemius SDK from v1.2.1.6 to v1.2.1.7.1
- May 25, 2017
- Enhancement: Support for PHP's strtotime(); allows you to set start_time="now" and/or end_time="+3 hours". NOTE: end_time is relative to start_time, not to "now" (unless start_time is set to "now").
- Changed minimum required WordPress version to 4.6 for translation purposes.
- April 3, 2017
- Enhancement: Hourly Horizontal forecast now displays on a single row and scrolls horizontally if necessary. There is also an option to disable this horizontal scrolling and display in multi-row like it used to be.
- Fix logic for checking if start_time is empty.
- March 24, 2017
- Improved logic for loading plugin assets
- Update Gamajo Template Loader from 1.2.0 to 1.3.0
- March 24, 2017
- Fix: Add missing Climacons SVG file
- Rename action hook from
get_template_part_tk_event_weather_hourly_horizontaltotk_event_weather_get_template_part_hourly_horizontal(similar renaming for other template names) - Change plugin's Tools tab shortcode usage examples to instead link to this plugin's WordPress.org FAQs to avoid having to upkeep them in more than one place.
- March 11, 2017
- Enhancement: If start_time or end_time begins with capital "T" (leaving out the YYYY-MM-DD part of the ISO 8601 format), today's date from WordPress' current_time( 'Y-m-d' ) will be used
- Updated Freemius SDK from v1.2.1.5 to v1.2.1.6
- March 10, 2017
- Released TK Event Weather for Simple Calendar
- Enhancement: End Time can now be blank/unused and will default to displaying the remaining hours of the day.
- Enhancement: End Time can now equal Start time to display a single hour's weather. Note that if you enter 5:30am for both Start and End time, the output will be both 5am and 6am (and possibly a 3rd time in the middle with the sunrise or sunset). If you really only want a single hour displayed, you should only enter top of the hour (e.g. 5am or 6am) and also use
sunrise_sunset_off=true. Example screenshot: https://cl.ly/2N2X1p1C1O1r - Enhancement: New "before" (h4) and "after" (p) shortcode arguments to output certain text only if the shortcode has output. Useful for a heading like "Forecast" or some text at the end of the shortcode's output, like a disclaimer about the weather not being guaranteed.
- February 10, 2017
- Fix for PHP versions below 5.5.0 to remove expressions from empty() and now only variables are used.
- Minor tweaks around date_i18n()
- January 19, 2017
- Paid add-ons: lower single-site prices and bulk purchasing is now available (discounted pricing when buying for multiple sites at once).
- Tested with WordPress 4.7.1
- Breaking change: Reworked time-based functions due to the Dark Sky API response deprecating 'offset'. Uses 'timezone' response now to retrieve the timezone of the specified location, which makes this plugin display more accurately.
- Enhancement: Added Time Format options (time_format_hours and time_format_minutes shortcode arguments). Reference date_i18n() and WordPress' Formatting Date and Time article for available time formats. This also changed the Hourly and Vertical templates, if you have customized those.
- Changed transient name
- Fixed error if weather API does not return a sunrise and/or sunset time (e.g. sun does not rise or set this day).
- Added WP Timezone, Date Format, and Time Format to the Help tab's system information report.
- January 4, 2017
- Added support for Visible Edit Shortcuts in the WP Customizer
- Released TK Event Weather for Events Manager
- January 3, 2017
- Updated Freemius SDK from v1.2.1 to v1.2.1.5
- October 30, 2016
- Breaking Change: Updated references and code for The Forecast.io API getting renamed to The Dark Sky API as of September 20, 2016. You will need to re-enter your API key and other settings specific to The Dark Sky API.
- Updated Freemius SDK from v1.2.0 to v1.2.1
- August 24, 2016
- Fix
classshortcode parameter (existed before but was not implemented into the output) - Updated Freemius SDK from v1.1.9 to v1.2.0
- July 22, 2016
- Updated Freemius SDK from v1.1.8.1 to v1.1.9
- July 22, 2016
- Version bump
- July 22, 2016
- Added extra data validation check for when shortcode's Event End Time is earlier than the Event Start Time.
- May 9, 2016
- Added Title text to sunrise and sunset icons (text displays on hover, like other icons' Title text) in both Horizontal and Vertical templates.
- Add-on updates can now be detected and automatically updated (updated to Freemius v1.1.8.1).
- Plugin settings that allow numerical entry (e.g. Past Cutoff Days) can now be "blanked out" back to their defaults. Fixes issue of blank out resulting in zero value (unlimited days) due to absint() evaluating to zero for blank text input.
- Added links to TourKick's (my) and Freemius' (vendor) Terms (includes Privacy Policies) and "By using this plugin, you agree to these Terms" sort of text at the Freemius opt-in page and the plugin settings greet box area.
- April 27, 2016
- Remove usage of boolval() because it's only available in PHP 5.5.0+ and this plugin currently only requires PHP 5.0.
- April 26, 2016
- New "location" shortcode argument to enable use of Google Maps Geocoding API to retrieve latitude and longitude automatically (subject to API usage limitations or may require a Google Maps Geocoding API key).
- New "Tools" tab in plugin's settings page to use Google Maps lookup without being subject to API usage limitations (enter an address, get the coordinates, manually paste them into wherever you're using the shortcode).
- Tools tab includes shortcode examples (just for convenience) and Google Maps attribution and Terms.
- Always load shortcode's CSS file for Administrators so shortcode error messages get styled.
- New version of Freemius now allows Add-on Trials without needing to enter a credit card (only for users who have Allowed tracking and have confirmed their email address).
- April 11, 2016
- Fix for Freemius welcome message
- April 11, 2016
- Initial version