Astero Weather Plugin v 1.2.6 Documentation
a premium WordPress Weather Plugin
Thank you for purchasing our plugin. If you have any questions beyond the scope of this help file, please feel free to email us at support@archtheme.com.
Don't forget to RATE US if you like our plugin! :D
Before installing the plugin you should already have WordPress installed.
For information regarding WordPress installation, please visit - http://codex.wordpress.org/Installing_WordPress
-
Extract the zipped package downloaded from CodeCanyon to your local computer.
-
The plugin zip is named astero.zip in the root folder.
-
Navigate to Plugins > Add New > Upload Plugin, select astero.zip and press Install Now.
-
After the plugin is installed, remember to go to Plugins > Installed Plugins to Activate Astero Weather Plugin.

Astero Weather Plugin uses the Open Weather Map API or Forecast.io API for its weather services. You may choose a different weather service provider for each weather display.
-
To use the Open Weather Map API for weather services, please sign up for a free or paid API key here.
-
To use the Forecast.io API for weather services, please sign up for a free or paid API here.
-
Go to Settings > Astero Weather.
-
Enter the respective OpenWeatherMap API Key and/or Forecast.io API Key and click Save Changes.

To add a new weather, go to Astero Weather > Add New Weather.
Astero Weather Options
-
Weather Service Provider: Choose a weather service provider either from Openweathermap ( supports only http) or Forecast.io (supports http or https with a credit link in accordance to their usage policy).
-
Location: Detect user location with Html5 Geolocation and IP fallback or use IP detection only which may be less accurate but does not prompt user for input or Enter City and Country name with Default Location.
-
Latitude: Used only for Forecast.io service and fixed location. Latitude will be updated automatically when you save the post with a valid location. You may also manually update the latitude.
-
Longitude: Used only for Forecast.io service and fixed location. Longitude will be updated automatically when you save the post with a valid location. You may also manually update the longitude.
-
Custom Location Name (Optional): Allow user to specify a custom name instead of the location city. Only available if Location is set to Default Location.
-
Units: Choose Metric for °C and meters per second and Imperial for °F and miles per hour.
-
Temperature Unit Style: Whether to display °C | °F or only °.
-
Layout: Simple Layout with Fullscreen Overlay or Full Forecast Layout.
-
Language: Choose language. Open Weather Map currently supports 18 languages. Forecast.io supports 12 languages. You may use your own translation if you choose Open Weather Map as the service provider. Texts that require translation from Open Weather Map all begin with "own_translation" in the .po file. Additional texts that require translation are included in the .mo and .po files.
-
Search: Enable search function in the weather forecast.
-
Border: Select border style. You may enter border width, border style and border color.
-
Rounded Corners: Adds rounded corners to weather display.
-
Font: Choose from 600+ Google fonts. Optionally select font weight and font color.
-
Base Font Size: Adjust this value to change overall font size.
-
Temperature Font Size: Adjust this value to change the temperature size only.
Background Style
-
Color Background: Choose solid color background
-
Image Background: Choose image background. Use default images or upload custom images for 7 weather conditions (Clear Day, Clear Night, Cloudy, Rain, Thunderstorm, Fog and Snow).
-
Video Background:
-
Html5 Video: Supports .mp4, .webm and .ogg. For most cross browser support, at least .mp4 and .webm are recommended. Optionally upload a placeholder image for unsupported browsers.
-
YouTube Embed: Insert a YouTube video ID.E.g. For http://www.youtube.com/watch?v=pfqnykqgaoa&key=value, enter pfqnykqgaoa. To ensure full screen display, select the correct aspect ratio.
After setting all options, click Publish to save the post. A shortcode will be automatically generated for use anywhere in the site, and the weather display will be available in the widget.
Tip: To change the text for searching location weather, open the file .po under /wp-content/plugins/astero/languages/astero-en_US.po with Poedit, and edit the text "I want to find the weather for %1$s in %2$s ." %1$s is the placeholder for the location input, and %2$s is the placeholder for the unit dropdown.

To include Astero Weather anywhere on your site, go to Astero Weather and copy the shortcode under the column Shortcode, eg [astero id="100"]

Text Translation
-
Download and install Poedit.
-
Translation files ( .mo & .po ) are located under wp-content/plugins/astero/languages.
-
Duplicate astero-en_US.po under the same directory and rename the copied file with the new language code and country code, e.g. astero-de_DE, astero-fr_FR. Click here for a complete list of language codes and here for the list of country codes.
-
Open the new file with Poedit to translate the text strings. Click Save after you are done and the .mo file will be automatically generated.
Open Weather Map Own Translation
-
Go to Astero Weather and edit your weather display.
-
Select Weather Service Provider > Open Weather Map.
-
Select Language > Own Translation.
-
Open the duplicated .po with the target language from the above instructions.
-
Translate all texts that begin with "own_translation". Click Save after you are done and the .mo file will be automatically generated.
Tip: Visit http://codex.wordpress.org/Translating_WordPress for more information regarding WordPress localization.
Images & Icons
Scripts & Framework