Title: LiraScope Author: lirascope Published: September 25, 2026 Last modified: September 25, 2026 --- Search plugins ![](https://ps.w.org/lirascope/assets/banner-772x250.png?rev=3712890) ![](https://ps.w.org/lirascope/assets/icon.svg?rev=3712890) # LiraScope By [lirascope](https://profiles.wordpress.org/lirascope/) [Download](https://downloads.wordpress.org/plugin/lirascope.1.0.0.zip) * [Details](https://wordpress.org/plugins/lirascope/#description) * [Reviews](https://wordpress.org/plugins/lirascope/#reviews) * [Installation](https://wordpress.org/plugins/lirascope/#installation) * [Development](https://wordpress.org/plugins/lirascope/#developers) [Support](https://wordpress.org/support/plugin/lirascope/) ## Description LiraScope adds server-rendered shortcodes and dynamic blocks for Syrian Pound exchange rates. It shows the Central Bank rate and the market rate as separate sources, including the spread between them. The plugin works without an API key. Public mode is the default and includes every display in this release. Client mode uses an existing LiraScope API key for metered requests and falls back to public data when enabled. A key adds account routing; it does not unlock plugin code or place a licence restriction on the plugin. Included displays: * One exchange-rate figure, using the consistent sell, then mid, then buy basis. * A sortable and filterable rates table. * The official-versus-market gap with widest, narrowest, and current values. * A currency calculator with current or archived rates. * Accessible history and multi-currency comparison charts with visible data tables. * Gold and cryptocurrency tables with history charts. * Market analysis links and current LiraScope service status. * Bounded CSV exports streamed through a temporary file. * An externally hosted image card that refreshes once a minute. Two classic widgets provide the single-rate and rates-table displays. Client mode also shows plan usage and lets administrators create, edit, test, delete, and rotate webhook secrets. A signing secret is shown only once after creation or rotation. All displays show new SYP and can show the old-SYP value multiplied by 100. Arabic, English, German, Turkish, Kurdish Sorani, and Kurdish Kurmanji are included. Arabic and Sorani render right to left. No front-end credit link appears unless an administrator enables the clearly labelled attribution setting. Source code and development files are available at https://github.com/OMARINO-DE/ LiraScope/tree/main/plugins/wordpress/lirascope #### Shortcodes * `[lirascope_rate currency="USD" source="market"]` * `[lirascope_table currencies="USD,EUR,TRY" source="market"]` * `[lirascope_gap currency="USD" days="180"]` * `[lirascope_widget pair="USD" source="market" size="card" theme="auto"]` * `[lirascope_calculator from="USD" to="SYP" source="market"]` * `[lirascope_chart currency="USD" days="30" mode="history"]` * `[lirascope_chart currencies="USD,EUR,TRY" days="30" mode="comparison"]` * `[lirascope_gold type="24K" days="30"]` * `[lirascope_crypto symbol="BTC" days="30"]` * `[lirascope_analysis take="5"]` * `[lirascope_status]` * `[lirascope_export currency="USD" days="30" kind="history"]` Each shortcode has a matching dynamic block and uses the same PHP renderer. #### WooCommerce currency feeds When WooCommerce and a supported multi-currency plugin are active, LiraScope supplies the SYP rate through FOX/WOOCS, CURCY Custom Finance API, WCML, or Booster. Each adapter follows that plugin’s documented rate direction. Market mode quotes the store base currency directly when available and otherwise reconstructs it through the USD cross-rate payload. Central Bank mode supports only USD as the store base because the cross-rate endpoint is market-derived. Other base currencies are refused and an administrator notice explains why. For CURCY, select Custom under Multi Currency > Update > Finance API. The filter is part of CURCY’s paid-plugin documentation and is registered only when CURCY is active. #### External services LiraScope depends on the LiraScope service operated by OMARINO IT Services at `lirascope. syria-cloud.sy`. **Server-side API requests:** On a display render or local REST-proxy request, the plugin contacts the service only when its local cache has no usable response. It sends currency codes and bounded query parameters. In client mode it also sends the configured `X-Api-Key` and `X-Api-Secret` headers. The User-Agent contains only` LiraScope-WordPress` and the plugin version; it does not contain the installing site’s URL. The service processes the WordPress server’s IP address for rate limiting. Results are cached for at least five minutes, and stale data is used during temporary upstream errors. **Embed card:** If a site owner places the Embed Card block or shortcode, each visitor’s browser requests an image directly from `lirascope.syria-cloud.sy` once per minute while the page is open. The service receives the visitor’s IP address and normal` Referer` or `Origin`, from which it derives the embedding hostname. It also receives the selected pair, source, and optional embed identifier. The hostname and render counts are retained as daily aggregate statistics. The plugin ships its own refresh script and never downloads executable code from LiraScope. **Webhook management:** In Client mode, webhook actions send the webhook URL, label, currency, threshold, and alert type entered by an administrator to LiraScope. The service stores this configuration against that API client. Requests occur only when an administrator opens the account panel or explicitly creates, edits, tests, deletes, or rotates a webhook. Service terms: https://lirascope.syria-cloud.sy/en/legal/terms Service privacy policy: https://lirascope.syria-cloud.sy/en/legal/privacy #### Privacy The plugin stores an HMAC identifier derived from a visitor IP and a one-minute time window to enforce its local REST-proxy limit. It never stores the raw visitor IP. These counter rows expire within 25 hours. Cached API data contains exchange- rate information, not visitor information. The Embed Card is externally hosted media and performs aggregate third-party measurement as described under External services. Do not place that block or shortcode unless the site’s privacy notice covers this request. The plugin adds precise suggested wording to WordPress’s Privacy Policy Guide. The API key and secret are stored in WordPress options with autoload disabled unless they are supplied as constants in `wp-config.php`. The secret field is never printed back into the settings page. A blank save keeps it; the separate Remove secret action clears it. ## Blocks This plugin provides 11 blocks. * LiraScope Status Current LiraScope service status and component health. * LiraScope Embed Card An externally hosted LiraScope rate image that refreshes once a minute. * LiraScope Crypto Latest cryptocurrency prices with a historical chart and semantic data table. * LiraScope Rates Table A sortable and filterable exchange-rates table. * LiraScope Gold Latest gold prices with a historical chart and semantic data table. * LiraScope Chart Accessible history, comparison, or normalized exchange-rate chart. * LiraScope Rate One Syrian Pound exchange-rate figure. * LiraScope Export Download current or historical exchange-rate data as CSV. * Official vs Market Gap The spread between the official and market Syrian Pound rates. * LiraScope Market Analysis Recent LiraScope daily market briefs in the selected locale. * LiraScope Converter Convert currencies using today’s rate or a historical closing rate. ## Installation 1. Upload the `lirascope` folder to `/wp-content/plugins/`, or install the zip through Plugins > Add New > Upload Plugin. 2. Activate LiraScope. Network activation is supported; each site receives its own settings and local counters table. 3. Open Settings > LiraScope. 4. Keep Public mode for key-free use, or enter an existing LiraScope API key and secret and select Client mode. 5. Add a LiraScope block or shortcode to a page. No account or API key is required for the plugin’s display functionality. ## FAQ ### Does the plugin require an API key? No. Public mode is the default and supports every display in this release. Client mode is for sites that already have LiraScope API credentials. ### Why can the latest-rate cache not be set below five minutes? The upstream service also caches current rates for five minutes. Faster polling would repeatedly download the same response and could consume shared-hosting rate limits without making the displayed rate newer. ### Which number is used when one figure represents a rate? The plugin uses sell, then mid when sell is absent, then buy when both are absent. This is the same basis used by the LiraScope website and gap calculation. ### Does the plugin send my site address in its User-Agent? No. The server-side User-Agent contains only the product name and plugin version. An Embed Card image is different: the visitor’s browser normally sends `Referer` or `Origin`, as disclosed above. ### Can visitors use a paid API key through the calculator or export links? Only parameter sets registered by a placed block, shortcode, or widget may cause a keyed cache miss. Other valid requests use the public API. Site-wide and per- visitor budgets still apply, and CSV exports are capped at 20 MB. ### Can I remove all plugin data? Yes. Deactivation keeps settings and cache data. Deleting the plugin through WordPress runs its uninstall routine across every multisite site, removes all `lirascope_*` options and transients, drops the local counters table, and removes temporary files. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “LiraScope” is open source software. The following people have contributed to this plugin. Contributors * [ lirascope ](https://profiles.wordpress.org/lirascope/) [Translate “LiraScope” into your language.](https://translate.wordpress.org/projects/wp-plugins/lirascope) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/lirascope/), check out the [SVN repository](https://plugins.svn.wordpress.org/lirascope/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/lirascope/) by [RSS](https://plugins.trac.wordpress.org/log/lirascope/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * Initial review-ready release with settings, public/client routing, local budgets, eleven shortcodes, eleven dynamic blocks, classic widgets, WooCommerce feeds, streamed exports, client usage and webhook controls, six locales, RTL support, and the REST proxy. ## Meta * Version **1.0.0** * Last updated **12 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.7 or higher ** * Tested up to **7.1.2** * PHP version ** 7.4 or higher ** * Tags * [block](https://wordpress.org/plugins/tags/block/)[currency](https://wordpress.org/plugins/tags/currency/) [exchange rates](https://wordpress.org/plugins/tags/exchange-rates/)[rtl](https://wordpress.org/plugins/tags/rtl/) * [Advanced View](https://wordpress.org/plugins/lirascope/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/lirascope/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/lirascope/reviews/) ## Contributors * [ lirascope ](https://profiles.wordpress.org/lirascope/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/lirascope/)