FAIR

Federated and Independent Repositories

ICOUK Hijri Date

Plugin Banner

ICOUK Hijri Date

by icoukplugin

Download
Description

The ICOUK Hijri Date plugin allows you to easily display the current Hijri date on your WordPress website. Perfect for Islamic websites, mosques, and communities who need to show the Islamic calendar date.

Features

  • Display current Hijri date using shortcode
  • Configurable country settings
  • Secure API authentication
  • Easy to use and integrate
  • Responsive design
  • Error handling and user feedback

How to Use

  1. Install and activate the plugin
  2. Go to Settings > ICOUK Hijri Date
  3. Enter your API Bearer token
  4. Set your country (defaults to UK)
  5. Use the shortcode [icouk_hijri_date] in any post or page

Shortcode

Use the shortcode [icouk_hijri_date] to display the current Hijri date anywhere on your website.

Shortcode Attributes:
– class – Add custom CSS classes (e.g., [icouk_hijri_date class="my-date"])
– style – Add custom inline styles (e.g., [icouk_hijri_date style="color: red; font-size: 18px;"])

Configuration

The plugin requires configuration before use:

  1. Bearer Token: Enter your Moon Sighting UK API authentication token
  2. Country: Set your country code (defaults to UK)
  3. Custom CSS: Add custom styling for the Hijri date display

Custom Styling

You can add custom CSS in the plugin settings to style the Hijri date display. The CSS will be applied to the .icouk-hijri-date container.

Example CSS:
css
.icouk-hijri-date {
font-size: 18px;
color: #2c5aa0;
font-weight: bold;
text-align: center;
padding: 10px;
background: #f5f5f5;
border-radius: 5px;
}

API Integration

This plugin integrates with the Moon Sighting UK API to fetch accurate Hijri date information. The API is free to ICOUK registered members. You’ll need to obtain an API key from the Moon Sighting UK service.

External Services

This plugin connects to the Moon Sighting UK API to obtain current Hijri date information. This service is required to display the accurate Islamic calendar date on your website.

What data is sent and when:
– Your configured country code (e.g., “UK”, “MA”) is sent with each API request
– Your Bearer token is sent for authentication
– API requests are made when the shortcode is displayed on your website
– Data is cached for 10 minutes to reduce API calls

Service Provider: Moon Sighting UK (ICOUK)
– Website: https://www.moonsighting.org.uk/
– API Endpoint: https://www.moonsighting.org.uk/api/index.php/v1/
– Terms of Service: https://www.moonsighting.org.uk/terms-of-use.html
– Privacy Policy: https://www.moonsighting.org.uk/privacy-policy.html

Data Transmission:
– Country code and Bearer token are transmitted over HTTPS
– No personal user data is collected or transmitted
– API responses are cached locally to minimize external requests

  1. Upload the plugin files to the /wp-content/plugins/icouk-hijri-date directory, or install the plugin through the WordPress admin screen.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Go to Settings > ICOUK Hijri Date to configure the API settings
  4. Use the shortcode [icouk_hijri_date] in your posts or pages
Do I need an API key?

Yes, you need a Bearer token from the Moon Sighting UK API service to use this plugin.

Can I change the country?

Yes, you can configure the country in the plugin settings. The default is UK.

Where can I use the shortcode?

You can use the shortcode [icouk_hijri_date] in posts, pages, widgets, or any area that supports shortcodes.

What if the API is down?

The plugin includes error handling and will display a user-friendly error message if the API is unavailable.

Is this plugin free?

Yes, this plugin is free to use and is released under the GPL license.

1.0.0

  • Initial release
  • Basic Hijri date display functionality
  • Settings page for API configuration
  • Shortcode support
  • Error handling
Back to top