Fale Hafez
Hafez Poetry Randomizer Plugin The Hafez Poetry Randomizer is a delightful WordPress plugin that brings the enchanting world of Hafez’s poetry to your website. With just a simple shortcode, you can easily display random…
Use with caution
Fale Hafez works, but test it on a staging site before relying on it in 2026. It runs on 10+ sites and was last updated 4 months ago, and scores 51/100 on our health check.
- Small user base (10+ active installs)
- Very few reviews so far
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Fale Hafez stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| falehafez | #1 |
| hafez | #1 |
| فال حافظ | #1 |
| حافظ | #2 |
Version adoption
Share of active sites per release.
About Fale Hafez
From the official readme · v1.0.2Description
Hafez Poetry Randomizer Plugin
The Hafez Poetry Randomizer is a delightful WordPress plugin that brings the enchanting world of Hafez’s poetry to your website. With just a simple shortcode, you can easily display random verses of Hafez’s timeless poetry to your visitors, adding a touch of cultural elegance to your site’s content.
About Hafez
Hafez, whose full name is Shams-ud-Din Muhammad Hafez, was a 14th-century Persian poet renowned for his mystical and lyrically beautiful poetry. Born in Shiraz, Iran, Hafez is often referred to as the “Tongue of the Hidden” due to his ability to convey deep spiritual and philosophical insights through his verses. His poetry, collected in the Divan-e-Hafez, remains an enduring treasure of Persian literature and Sufi mysticism. Hafez’s works explore themes of love, spirituality, fate, and the human condition, and his ghazals (lyric poems) continue to inspire and resonate with people around the world, transcending time and culture. His verses are celebrated for their profound wisdom and the way they capture the essence of human emotions and the divine in a unique and enchanting manner.
Features
Random Poetry Display: The plugin allows you to effortlessly display randomly selected verses from the poetry collection of the renowned Persian poet, Hafez.
Easy Integration: By using the [Hafez_random] shortcode, you can seamlessly insert the random poetry generator into any post, page, or widget area.
Cultural Enrichment: Share the beauty and wisdom of Hafez’s poetry with your website visitors, introducing them to the rich literary heritage of Persian culture.
Demo
Experience the magic of the Hafez Poetry Randomizer yourself by visiting our website 6arshid.
Feedback and Support
We appreciate your interest in the Hafez Poetry Randomizer plugin. If you have any questions, feedback, or issues, please don’t hesitate to contact our support team.
Installation
Usage
Install and activate the Hafez Poetry Randomizer plugin.
To showcase a random Hafez poem, simply insert the [Hafez_random] shortcode into your desired content area.
Publish or update your post or page, and watch as the plugin magically displays a new verse every time the content is loaded.
Changelog
0.0.1
- Unveiling the Inaugural Release of the Hafez WordPress Plugin
1.0.1
- Edit information
1.0.2
- Added [FAL_PAGE] shortcode – displays a fully styled Hafez fortune-telling intro page with an editable title, subtitle, description, and a call-to-action button that links to the random poem page
- Added “Fal Page” sub-menu under the Fale Hafez admin menu for editing all content of the intro page without touching code
- Added live preview panel in the admin settings page that updates in real time as the admin types
- Added “Auto-detect” button that automatically finds the page containing [HAFEZ_RANDOM] and fills in the link field
-
Added one-click “Create Page” button in the Fal Page settings that creates a WordPress page with [FAL_PAGE] and saves the page ID
-
Redesigned the main admin panel (Fale Hafez → Fale Hafez) with a full PHP-rendered dashboard replacing the previous JavaScript innerHTML approach
- Added two status cards showing whether the random poem page and the intro page have been created, with direct View and Edit links
- Added “Create All Pages Automatically” button on the main panel that creates both required pages in one click and links them together — no shortcode copy-pasting needed
- Added shortcode reference grid on the main panel for quick access
-
Fixed the CTA button on [FAL_PAGE] not navigating anywhere when the random page URL had not been saved yet — added automatic URL detection fallback at render time
-
Wrapped [HAFEZ_RANDOM] output in a decorative gold-bordered frame with ornamental dividers above and below the poem
- Added “فال جدید” (New Fortune) button below every random poem
- New fortune is fetched via AJAX — the page does not reload; the poem fades out, updates, and fades back in smoothly
- Added spinning refresh icon animation on the button during loading
-
Registered wp_ajax and wp_ajax_nopriv action fh_get_random as the AJAX endpoint
-
Added ABSPATH guard to class-faleHafez-public.php to prevent direct file execution
- Added current_user_can() capability check to all admin form handlers in addition to nonce verification — prevents privilege escalation if a valid nonce were obtained by a lower-privilege user
- Applied wp_kses_post() to the return value of the [faleHafez_hafez_poem] shortcode to prevent XSS if database content were ever tampered with
- Changed SELECT * to SELECT content in all poem database queries to minimise data exposure
- Added per-IP rate limiting (30 requests per 60 seconds) to the public AJAX endpoint using WordPress transients to prevent database spam
- Removed debug error_log(json_encode($content)) call that was leaking poem data to the server error log
- Changed relative require_once(‘functions.php’) to an absolute path using DIR for reliability across all server configurations
Screenshots
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
FAQ
Fale Hafez: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Oct 19, 2026
Is Fale Hafez free?
Yes. Fale Hafez is free to download and use from the official WordPress.org plugin directory.
Is Fale Hafez safe to use in 2026?
Fale Hafez works, but test it on a staging site before relying on it in 2026. It runs on 10+ sites and was last updated 4 months ago, and scores 51/100 on our health check.
How many websites use Fale Hafez?
Fale Hafez is active on 10+ WordPress websites and has been downloaded 1,444 times since it launched in July 2024. It was downloaded 73 times in the last 30 days.
Does Fale Hafez work with WordPress 7.1?
Fale Hafez is officially tested up to WordPress 7.0.7, while the latest release is 7.1.3. It may still work, but try it on a staging site first.
When was Fale Hafez last updated?
The latest version, 1.0.2, was released on June 25, 2026 (4 months ago).
Who makes Fale Hafez?
Fale Hafez is developed and maintained by 6arshid.
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card
