== IP2Location World Clock ==
Contributors: IP2Location
Donate link: https://www.ip2location.com
Tags: world clock, analog clock, digital clock, clock, local time, visitor's time, custom time zone, time
Requires at least: 2.0
Tested up to: 7.0
Stable tag: 1.2.2

Simple world clock widget to display analog or digital clock for multiple time zone on your site. Supported local time, visitor's time and custom time zone selection.

== Description ==
Simple widget to display analog or digital clock on your website without much hassle. IP2Location world clock gives you a range of different clock designs which is absolutely free. Supported local time, visitor's time and custom time zone selection.


= Features =
- World clock widget enable you to easily embed into your website in anywhere
- 46 different clock designs to choose from and the list is still growing
- 3 option of time selection (local time, visitor's time and custom time zone).
- Support 12 hour or 24 hour time format for digital clock.
- Can be added via shortcode [ip2location_world_clock], please refer FAQ section for shortcode parameters.


== Frequently Asked Questions ==
= Where do I start? =
Go to **Dashboard >> Appearance >> Widget** and set this plugin your *sidebar*. Then, go to menu page to select your clock design and display time.

= Do I need to download IP geolocation BIN file after the plugin installation? =
Yes, if you are going display the visitor's time. You can download the latest IP2Location Database BIN file from https://lite.ip2location.com/ (Free) or https://www.ip2location.com/ (Commercial). Please take note to download the DB11 edition which contains the time zone information.

= Do I need to regularly update the BIN file? =
We encourage you to update your BIN file every month so that your plugin can display the correct time according to visitor's geolocation.

= Can I insert a clock in posts or pages? =
Yes, the shortcode **[ip2location_world_clock]** is available.

= What is the default display of shortcode? =
The default display of shortcode is based on your settings in IP2Location World Clock Menu.

= What parameters are available for shortcode? =
**design** - Use **'a'** followed by the position of the analog clock design shown in IP2Location World Clock Menu whereas use **'d'** followed by the position of the digital clock design shown in IP2Location World Clock Menu. The position of clock design is counted from top to bottom and left to right. For instance, use 'a1' for first analog clock design wheareas use 'd5' for fifth digital clock design.

**time** - Use **local** for Local Time, **visitor** for Visitor’s Local Time and **custom** for Custom Time Zone.

**utc** - Use this parameters when you are using Custom Time Zone. Values available are from **-12 until +14**. You may refer the values in IP2Location World Clock Menu.

= Examples of shortcode with parameters? =
Display second design of analog clock in local time
**[ip2location_world_clock** **design="a2"** **time="local"]**

Display fifth design of digital clock in visitor's local time
**[ip2location_world_clock** **design="d5"** **time="visitor"]**

Display first design of digital clock in custom time zone of +4:00
**[ip2location_world_clock** **design="d1"** **time="custom"** **utc="+4"]**

== Installation ==
###Using WordPress Dashboard
1. Select **Plugins >> Add New**.
2. Search for "IP2Location World Clock".
3. Click on *Install Now* to install the plugin.
4. Click on *Activate* button to activate the plugin.
5. Download IP2Location database from https://lite.ip2location.com/ (Free) or https://www.ip2location.com/ (Commercial)
6. Decompress the .BIN file and upload to `wp-content/uploads/ip2location`.
7. After installing you can see "Dashboard" a new menu "IP2Location World Clock".
8. Choose clock design and display time.
9. Save Changes.
10. Go to **Dashboard >> Appearance >> Widget**.
11. Set it your *sidebar*

###Manual Installation
1. Download and unzip the plugin. Upload the unzipped folder to the wp-contents/plugins/ip2location-world-clock` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Download IP2Location database from https://lite.ip2location.com/ (Free) or https://www.ip2location.com/ (Commercial)
4. Decompress the .BIN file and upload to `wp-content/uploads/ip2location`.
5. After installing you can see "Dashboard" a new menu "IP2Location World Clock".
6. Choose clock design and display time.
7. Save Changes.
8. Go to **Dashboard >> Appearance >> Widget**.
9. Set it your *sidebar*.

== Screenshots ==
1. IP2Location World Clock settings page - analog clock design
2. IP2Location World Clock settings page - digital clock design
3. IP2Location World Clock widget page
4. IP2Location World Analog Clock display
5. IP2Location World Digital Clock display


== Changelog ==
= 1.2.2 =
* Tested up to WordPress 7.0.
= 1.2.1 =
* Tested up to WordPress 6.9.
= 1.2.0 =
* Tested up to WordPress 6.8.
= 1.1.10 =
* Fixed possible CSRF vulnerabilities.
= 1.1.9 =
* Tested up to WordPress 6.7
= 1.1.8 =
* Tested up to WordPress 6.6.1
= 1.1.7 =
* Tested up to WordPress 6.5
= 1.1.6 =
* Tested up to WordPress 6.4
= 1.1.5 =
* Tested up to WordPress 6.2
= 1.1.4 =
* Fixed database download issue
* Tested up to WordPress 6.1
= 1.1.3 =
* Minor fixes
* Tested up to WordPress 6.0
= 1.1.2 =
* Enhanced checking
= 1.1.1 =
* Fixed PHP warnings
= 1.1.0 =
* Added seasonal clock designs(Chinese New Year)
* Added time format for digital clock(12H & 24H)
= 1.0.9 =
* Added seasonal clock designs(Halloween Festival)
= 1.0.8 =
* Added seasonal clock designs(Mid-Autumn Festival)
= 1.0.7 =
* Added classic clock designs
= 1.0.6 =
* Minor fixes
= 1.0.5 =
* Added parameters for shortcode
= 1.0.4 =
* Added seasonal clock designs(Easter)
= 1.0.3 =
* Added seasonal clock designs(Valentine's Day)
* Minor fixes
= 1.0.2 =
* Added plugin review
* Added feedback request
= 1.0.1 =
* Added seasonal clock designs(Christmas)
* Added shortcode
= 1.0.0 =
* Initial release