=== Majed Arabic Demo Content ===
Contributors: majedbannani
Donate link: https://www.paypal.com/ncp/payment/2C3DDKHKMPMLC
Tags: demo content, arabic, woocommerce, sample data
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Import ready-made Arabic or English articles and WooCommerce demo products with local images, PDF downloads, and optional cleanup.

== Description ==

Majed Arabic Demo Content helps you populate a development or demonstration site with realistic Arabic or English content. Choose a collection, keep the default draft status or explicitly publish it, and import in small batches from one admin screen.

The English and Arabic admin interface follows your WordPress user language and supports both LTR and RTL layouts. Select Arabic or English independently of the admin language. Both libraries can coexist; this is not a multilingual translation-linking integration.

= Ready-made articles in two languages =

* Choose 12 or 24 articles per language across home, fashion, coffee, and stationery topics.
* Arabic articles contain approximately 394 to 452 words; English articles contain approximately 307 to 328 words, with an introduction, section headings, and practical examples.
* Includes excerpts, categories, tags, and featured images reused from the bundled product image library.
* Optionally update the text, excerpt, and featured image of previously imported articles while preserving their titles and publication status.

= WooCommerce demo products =

Import 28 parent products per language:

* 12 physical simple products.
* 4 variable products with 24 size/color variations in total, individual prices, stock quantities, and images.
* 4 native grouped products linked to their individually purchasable child products.
* 4 virtual, downloadable products with printable PDF worksheets in the selected language.
* 4 virtual service products.

Includes 60 local WebP images for main product images, galleries, and variations. Within each language, articles and products reuse imported images. Arabic and English use separate attachment records to preserve their own image titles and alt text, while the plugin bundles each source image only once. Prices use the store currency; these are sample products and prices, not a real product catalog or fulfillment service.

WooCommerce is optional for articles and required for importing or cleaning up products. No paid WooCommerce extensions are required. External/affiliate products, custom post types, and custom field integrations are not included.

= Import, update, and cleanup =

Imported items are drafts by default. Publishing is an explicit selection. Completed imports are skipped unless you select the article update option. Trashed items are always skipped during import. Keep the page open while importing; retry an interrupted operation to continue without creating duplicate completed items.

When development is finished, use the cleanup button to preview counts and confirm permanent deletion of tracked demo posts, products, variations, images, PDFs, and unused owned categories/tags. Deletion also removes edits made to the demo posts and products. It does not delete unrelated posts or products.

Media referenced by remaining WordPress content, post metadata, or options is retained. Used categories and items the current user cannot delete are retained. References stored only in third-party custom database tables cannot be detected by these checks. Categories and tags from versions before 1.1.0 are retained because those releases did not record term ownership.

Cleanup runs in batches and can be resumed by the same user after interruption. WooCommerce must be active to clean up its products. Deactivating or uninstalling the plugin does not automatically delete imported content or uploaded files.

= Local content and privacy =

The plugin requires no API key, account, subscription, AI request, or external content service. Its own code does not send site content or user information to external servers, add tracking, or load remote fonts. The demo text, images, and PDFs are bundled with the plugin.

The optional support button appears only on this plugin's admin screen. Clicking it opens an external PayPal payment page in your browser: https://www.paypal.com/ncp/payment/2C3DDKHKMPMLC . No PayPal API is used and no request to PayPal is made by the plugin unless the user follows that link in their browser.

= Bundled media and licensing =

The demo images were AI-generated for this project and are illustrative, without real customer data. Images accompanying digital products are not exact previews of the PDF worksheets. The eight PDFs (four per language) each contain four printable pages for handwritten planning; they are not interactive forms or confidential files.

Original plugin code and demo assets are distributed under GPLv2 or later to the extent copyright applies. The Arabic PDFs embed a subset of Amiri, licensed under the SIL Open Font License 1.1. See LICENSE.txt and licenses/THIRD-PARTY-NOTICES.txt for attribution and source information.

== Installation ==

1. Upload the ZIP using Plugins > Add New > Upload Plugin, or install from the WordPress plugin directory once available.
2. Activate Majed Arabic Demo Content.
3. Open Arabic Demo Content in the admin menu with an administrator account.
4. Choose Arabic or English content, then articles or products. Activate WooCommerce first if you want products.
5. Select draft or published status. For articles, choose 12 or 24.
6. Click Import demo content and keep the page open until completion.

== Frequently Asked Questions ==

= Does it work without WooCommerce? =

Yes. Article import and article cleanup work without WooCommerce. Product import and product cleanup require WooCommerce to be active.

= Will the plugin generate new content with AI? =

No. All text and media are already included locally. There are no live AI requests, API charges, or remote image downloads.

= Are the articles and products translated to English? =

The administration interface is available in English and Arabic. The bundled demo articles, product descriptions, categories, tags, variations and PDFs are available in Arabic and English. Choose the content language before importing.

= Will repeated imports create duplicates or overwrite my edits? =

Completed demo items are skipped by default. You may explicitly replace the text, excerpt, and featured image of previously imported articles. That option preserves existing titles and publication status. Interrupted, incomplete imports may be completed when you retry. Items in the trash are skipped.

= Can I delete everything imported by the plugin? =

The cleanup action covers both languages and previews the tracked items and asks you to confirm permanent deletion. It includes user edits to the demo posts/products. Shared media, used categories, unowned child variations and their parents, and items without sufficient delete permission may be retained. Older untracked terms and references in third-party custom tables are subject to the limitations described above.

= Are grouped products the same as product bundles? =

No. These use the native WooCommerce grouped product type, with separately purchasable child products. No bundle extension is required or simulated.

= Does it create real services, customer accounts, or orders? =

No. Services and digital listings are sample product data. The plugin does not create customer accounts or orders, schedule appointments, or provide fulfillment.

= What happens when I uninstall the plugin? =

Imported posts, products, and media remain. Use the explicit cleanup action first if you want to remove tracked demo content. Uninstalling by itself never runs cleanup.

== Screenshots ==

1. English administration: choose articles or products, set the quantity and status, and optionally update previously imported articles.
2. Arabic administration with RTL layout and translated import and cleanup controls.
3. A bundled article imported into WordPress with a featured image and expanded text. Its appearance depends on the active theme.

== Changelog ==

= 1.2.0 =
* Add a primary content-language selector and complete local English library: 24 articles, 28 products, 24 variations, categories, tags and four PDFs.
* Keep both libraries independently importable while preserving legacy Arabic ownership keys.
* Clean up both libraries, retaining shared and unowned content.
* Avoid mistaking known non-media core/WooCommerce settings for attachment references.

= 1.1.2 =
* Replace raw exception logging with opt-in, sanitized WooCommerce logging and an article-only diagnostic hook.
* Document narrowly scoped static-analysis exceptions for legacy ownership queries, fresh shared-media checks, and bundled translations.

= 1.1.1 =
* Prepare WordPress.org documentation, screenshots, and licensing notices.
* Use the OFL-licensed Amiri font in the bundled PDF worksheets.

= 1.1.0 =
* Expand all 24 Arabic articles and add reused featured images.
* Add optional updates for existing imported articles.
* Add confirmed, batched cleanup of tracked demo content and unused owned assets.
* Retain shared assets and untracked categories from older releases.

= 1.0.1 =
* Add the shared PayPal support card with English and Arabic translations.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.2.0 =
Adds local English content alongside Arabic. Existing Arabic imports remain tracked; cleanup covers both languages.

= 1.1.2 =
Safer diagnostics and reviewed static-analysis exceptions. Import and cleanup protections are preserved.

= 1.1.1 =
Adds publication documentation and openly licensed PDF typography. Import and cleanup behavior is unchanged from 1.1.0.
