== PlaceGen ==

Contributors:      scriptsdev
Tags:              placeholder, image-placeholder, placeholder-generator, developer-tools, web-design
Requires at least: 7.0
Tested up to:      7.0
Requires PHP:      8.0
Stable tag:        1.0.0
License:           GPL v2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Generate image placeholders from ZIP uploads while preserving folder structure, filenames, and image dimensions.

== Description ==

PlaceGen is a developer and designer utility plugin that converts real images into lightweight placeholders for demos, mockups, staging environments, and marketplace previews.

**Common Use Cases**

* Create lightweight demo content for themes and plugins
* Replace copyrighted images before client delivery
* Generate placeholders for staging websites
* Prepare ThemeForest preview packages
* Reduce package sizes during development


**Features**

* Replaces JPEG, PNG, GIF, and WebP images with clean placeholders
* Displays the original image dimensions on each placeholder
* Optional overlay text drawn on every placeholder
* Configurable background and text colors
* Configurable output format (PNG, JPEG, WebP, GIF)
* Customizable output ZIP filename suffix
* Preserve the original nested folder structure
* Preserve original filenames
* Non-image files inside the ZIP are left untouched
* Saved packages listed in the dashboard for easy re-download

== Installation ==

1. Upload the `placegen` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **PlaceGen** in the admin sidebar to start using the plugin.

== Frequently Asked Questions ==

= What image formats are supported? =

JPEG, PNG, GIF, and WebP files inside the uploaded ZIP are processed. All other files are left untouched.

= Are the original filenames preserved? =

Yes. The plugin always preserves original filenames — generated placeholders use the exact same name as the source file automatically.

= Is the original ZIP modified? =

No. The uploaded ZIP is extracted to a temporary directory. The originals are never modified; a new ZIP containing only placeholders is created and saved.

= Does it work with nested folders? =

Yes. The plugin recursively processes all images inside the ZIP regardless of folder depth, and the full folder structure is preserved in the output archive.

= What are the server requirements? =

The plugin requires PHP 8.0+, the GD image library (enabled by default on most hosts), and the ZipArchive PHP extension. Both are standard on virtually all WordPress-compatible hosting.

= Is there a file size limit for the uploaded ZIP? =

The plugin itself has no hard limit, but your server's `upload_max_filesize` and `post_max_size` PHP settings apply. If large uploads fail, ask your host to increase these values or use a staging environment where you control the PHP configuration.

== Screenshots ==

1. Dashboard — upload a ZIP and view saved packages.
2. Settings — configure colors, format, overlay text, and more.

== Privacy ==

PlaceGen does not send data to external services. All ZIP extraction and image processing occur locally on your server.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
