AlyawmGold Prices

AlyawmGold Prices adds responsive current-price tables and historical gold or silver charts to WordPress through two shortcodes. The plugin is designed for publishers, jewelry websites, financial education websites, and regional price portals. It supports English, Arabic, and Urdu front-end output, including RTL layouts. Key features:

• Current gold and silver references in supported local currencies.
• Gold prices for 24K, 22K, 21K, 18K, and 14K.
• Gram, troy ounce, kilogram, and supported tola views.
• Optional indicative local gold estimates when the selected AlyawmGold market provides them.
• Historical gold and silver charts in USD per troy ounce.
• Visitor controls for market and metal, plus interactive chart period and value selection.
• Server-side requests; no API key is exposed to visitors.
• WordPress transient caching and a last-successful-data fallback.
• Table, cards, compact, single-price, ticker, and slim header-bar layouts.
• Shortcode choices for market, width, minimum price-widget height, and chart height.
• Light, dark, and automatic themes.
• No advertising, visitor tracking, or remote JavaScript/CSS.
• Optional public attribution, disabled by default.
• The header bar hides the native scrollbar while retaining touch, keyboard, and arrow-button navigation.
• The shortcode builder shows a live preview of the selected widget before you copy its code.

Current prices: [alyawmgold_prices] Example with attributes: [alyawmgold_prices country="SA" metal="gold" karats="24,22,21,18" unit="gram" view="cards" theme="auto" language="ar"] Single price: [alyawmgold_prices metal="gold" karats="24" view="single"] Small bar below a site header: [alyawmgold_prices country="AE" metal="both" view="bar" width="full" height="64" controls="off"] The country attribute fixes the starting market. Set controls="on" to let visitors change market and metal, or controls="off" for a compact bar. Price-widget height is a minimum height: content can grow on narrow screens. width accepts auto, full, a pixel value such as 900px (bounded to 240–1600 px), or a percentage such as 75% (bounded to 25–100%). Width never exceeds the containing theme column. History: [alyawmgold_history metal="gold" period="30d" theme="auto" language="en"] Supported history periods are 7d, 30d, 60d, 90d, 6m, 1y, and 5y. Historical data in API v1 is intentionally shown in USD per troy ounce. The plugin does not convert old observations using today's exchange rate. History also accepts width, and height controls the chart area from 220 to 600 px. In block themes, place a Shortcode block below the Header template part in the Site Editor to show the price bar across a template. Placement in classic themes depends on the theme's template or widget areas. External service This plugin connects to the AlyawmGold public API at https://alyawmgold.com/api/v1 to obtain current and historical precious-metal data. This connection is necessary for the plugin's displayed prices and charts. Service endpoints used:

• https://alyawmgold.com/api/v1/spot/latest for current prices.
• https://alyawmgold.com/api/v1/history for historical data.

When a page containing a plugin shortcode is rendered and its local cache has expired, the WordPress server sends the selected country, metal, interval, and limit parameters required for that display. The server IP address and a plugin/version User-Agent are also visible as part of a normal HTTPS request. The plugin does not send visitor IP addresses, visitor cookies, account information, post content, comments, or behavioral analytics to AlyawmGold. Responses are cached in the WordPress database. A bounded set of last successful responses is retained so a website can continue to show clearly marked cached data during a temporary service failure. By configuring and using the plugin, the site administrator requests data from this service. Review the AlyawmGold terms and privacy information before use:

• Terms and data disclaimer: https://alyawmgold.com/legal/terms
• Privacy policy: https://alyawmgold.com/legal/privacy
• API documentation: https://alyawmgold.com/developers

1.5.2

• Keep the slim header bar from adding a hidden heading to every page where it appears.

1.5.1

• Keep the shortcode builder output readable without a native horizontal scrollbar.
• Start the builder with the saved default market and theme.

1.5.0

• Preview the actual current-price or history widget while changing shortcode builder choices in Settings > AlyawmGold Prices.
• Add preview loading, refresh, and connection error feedback without changing saved site settings.

1.4.2

• Replace the visible header-bar scrollbar with accessible previous/next controls when prices overflow.
• Keep swipe and keyboard scrolling, including right-to-left layouts and reduced-motion preferences.

1.4.1

• Validate market selections against supported API markets.
• Keep the cached-data indicator visible in the header price bar.
• Address WordPress Plugin Check findings for the plugin header, settings output, uninstall variables, and readme metadata.

1.4.0

• Add a slim price bar suitable for placement below a site header.
• Add shortcode and builder choices for width, price-widget minimum height, chart height, and visitor selectors.
• Keep market selection configurable in the shortcode.

1.3.2

• Keep chart date labels inside the plot in RTL layouts.

1.3.1

• Correct the settings page step numbers and duplicate heading.

1.3.0

• Refactor history period definitions and visitor update handling.
• Show the official logo in the WordPress settings page and compact layouts.
• Improve mobile history controls, RTL chart labels, and chart metric feedback.
• Keep smoothed chart lines within observed price movements.

1.2.2

• Improved badge contrast in the light theme.

1.2.1

• Keep the history chart visible after a visitor changes its period or metal.

1.2.0

• Use the official AlyawmGold gold and silver logo and a lighter website-inspired design.
• Let visitors change the current-price market and metal without reloading the page.
• Let visitors change history metal, period, and chart value; add 60-day history.
• Smooth the history chart curve while retaining the complete accessible data table.

1.1.1

• Correct the Arabic market heading order.

1.1.0

• Introduced a premium extension-inspired visual design for every price and history layout.
• Added clearer live, cached, market, currency, metal, and preferred-price indicators.
• Added a guided settings dashboard with a responsive shortcode builder and one-click copy.
• Replaced the free-text default market field with an accessible supported-market selector.
• Improved mobile layouts, dark mode, RTL presentation, error states, and reduced-motion support.

1.0.1

• Hardened API validation, caching, fallback behavior, and accessible chart interaction.
• Improved responsive layouts and compatibility with RTL themes.

1.0.0

• Initial release.
• Added current gold and silver prices with regional currencies and gold karats.
• Added historical gold and silver charts and accessible data summaries.
• Added English, Arabic, Urdu, RTL, responsive, and light/dark presentation.
• Added transient caching, last-successful-data fallback, admin settings, and optional attribution.