=== APlug Seiten- und URL-Zentrale ===
Contributors: aplug
Tags: pages, urls, bulk creation, csv import, site structure
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Plan, preview, create and roll back structured WordPress page and URL hierarchies from lists, CSV, JSON and structured text.

== Description ==

APlug Seiten- und URL-Zentrale helps administrators build large, structured WordPress websites without creating every page manually.

The plugin accepts simple lists, structured text, CSV and JSON. Administrators can define title and URL patterns with placeholders such as `{region}`, `{ort}`, `{branche}` and `{slug}`. Before any content is written, the plugin displays a preview with planned titles, slugs, paths, hierarchy levels and conflicts.

Core features:

* Simple list, structured text, CSV and JSON import.
* Arbitrary placeholder columns in title and path patterns.
* Automatic parent-page planning for hierarchical post types.
* Preview before all mass changes.
* Duplicate path and existing content detection.
* Conflict policies: skip, update with snapshot, unique suffix or fail.
* Draft-first safety defaults.
* Optional page template, taxonomy and navigation menu assignment.
* Batched REST processing for larger jobs.
* Job and item audit logs.
* Safe rollback with protection for content changed after the job.
* Optional handoff events for APlug TemplateStudio, SEO-Zentrale and Branchenregister.
* WordPress privacy exporter and eraser integration.
* Site Health diagnostics.
* No external services and no external data transmission.

The free plugin contains the complete local core workflow. A separate premium extension may add saved blueprints, scheduled synchronization jobs, advanced mapping rules, WP-CLI commands and multisite network templates. Premium code is not included in this package and the free plugin remains usable without it.

= Data ownership =

This plugin owns only its planning jobs, job items, rollback snapshots and audit records. The WordPress posts, pages, terms and navigation menu items created by a job remain standard WordPress data. Other APlug products receive data only through documented actions, filters or REST interfaces.

= Privacy =

The plugin stores the WordPress user ID that created a job so security-relevant mass changes remain attributable. It does not store IP addresses and does not transmit data to external services. WordPress privacy tools can export job metadata and anonymize user assignments. Created pages are editorial website content and are not automatically deleted by a personal-data erasure request.

= External services =

This plugin does not connect to external services.

== Installation ==

1. Upload the `aplug-seiten-url-zentrale` folder to `/wp-content/plugins/`, or install the ZIP in Plugins > Add New > Upload Plugin.
2. Activate “APlug Seiten- und URL-Zentrale”.
3. Open Seiten & URLs > Seitenplaner.
4. Paste a list, CSV, JSON or structured text.
5. Define the URL pattern, title pattern, post type and conflict policy.
6. Create and review the preview.
7. Execute the job in controlled batches.
8. Review results under Seiten & URLs > Aufträge & Rollback.

A full backup or staging test is strongly recommended before large production jobs.

== Frequently Asked Questions ==

= Does the plugin publish pages immediately? =

No. The safe default is draft. Direct mass publication is disabled until an administrator explicitly enables it in the plugin settings.

= Which input formats are supported? =

Simple one-title-per-line lists, hierarchy shorthand using `Parent > Child`, structured `key=value` text, CSV and JSON arrays are supported.

= How do placeholders work? =

Every imported column can be referenced in title and path patterns. A CSV column named `region` can be used as `{region}`. URL segments are sanitized with WordPress slug rules.

= Can the plugin create parent pages? =

Yes, for hierarchical post types. Missing URL path segments can be planned as structural parent pages and created as drafts.

= What happens when a URL already exists? =

Choose one of four policies: skip the row, update the existing content after saving a rollback snapshot, create a unique slug suffix, or mark the row as failed.

= Can all changes be undone? =

Created posts are moved to the Trash. Updated posts are restored from a snapshot. If a post was manually changed after the mass job, the normal rollback stops for that item to protect the later change. An administrator can explicitly force the rollback after reviewing the conflict.

= Does rollback restore every possible third-party field? =

No. Version 0.1.0 restores WordPress core post fields, the page template and assigned taxonomy terms. Arbitrary third-party custom fields and side effects performed by other plugins are not automatically restored unless those plugins implement the documented APlug handoff and rollback hooks.

= Does the plugin call external APIs? =

No.

= Is WP-CLI included? =

Not in the free prototype. WP-CLI is planned as a separate premium extension feature.

= Does uninstalling remove created pages? =

No. Created pages remain standard WordPress content. Plugin tables and settings are removed only when the administrator enables the explicit deletion setting before uninstalling.

== Screenshots ==

1. The page planner with input format, file import, placeholders and safety settings.
2. Preview summary with planned paths, hierarchy and conflict states.
3. Batched execution progress and completion state.
4. Job history with detailed item results and rollback controls.
5. Settings for batch size, retention, publication safety and uninstall behavior.
6. Help page with module manifest and integration information.

== Changelog ==

= 0.1.0 =

* Initial installable prototype.
* Added list, structured text, CSV and JSON parsing.
* Added placeholder-based title and path planning.
* Added hierarchy generation and conflict preview.
* Added batched REST execution.
* Added create, update, menu and taxonomy handling.
* Added audit logging and safe rollback.
* Added capabilities, privacy tools, Site Health and APlug module manifest.
* Added complete WordPress.org preparation documentation.

== Upgrade Notice ==

= 0.1.0 =

Initial prototype release. Test on a staging site and create a backup before using mass page creation on a production website.
