=== Cephei llms.txt Generator ===
Tags: llms-txt, ai, content
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate, edit and publish an llms.txt for your website. Free Cephei service; no registration, API key or license key required.

== Description ==

Cephei llms.txt Generator adds a page under Settings > llms.txt Generator. It automatically
uses this WordPress website's public home URL. There is no URL input field.

1. Click Generate llms.txt.
2. Wait for the public website crawl and AI generation to finish.
3. Review and edit the generated English text. Service comments are removed.
4. Click Publish to make the text available at /llms.txt.

Generating and editing do not change the published version. Failed or cancelled
generation keeps the previous editor contents and publication. Empty content
cannot be published. Only users with the manage_options capability can manage
the publication. The public file can be read without logging in.

The plugin stores the published text in the WordPress database and serves it as
text/plain; charset=utf-8 at the domain-root /llms.txt. No FTP access or writable
file in the document root is required. The URL is checked before publishing and
the public content is checked afterwards. WordPress must receive requests for
this path, usually through the site's existing pretty-permalink routing.

English and German (de_DE) interfaces are included. The service generates English
ASCII text regardless of the website language. You can edit the result, including
adding UTF-8 characters. Maximum publication size: 1 MiB.

The plugin and service are free to use, with no registration, paid upgrade,
subscription or license key. Cephei AG provides the tool to introduce its work.
Company information is confined to this plugin's settings page. No promotional
links or credits are automatically added to your public website or llms.txt.

llms.txt is an emerging proposal, not a guarantee of inclusion, ranking, citation
or use by any AI system. Review generated content before publishing.

== External service ==

This plugin relies on the public Cephei llms.txt generator at
https://llms.cephei.ai/ for crawling and AI generation. No AI model runs on your
WordPress server.

* When: only after an administrator clicks Generate llms.txt. Installing,
  activating, opening the settings page and publishing do not call the generator.
* Sent: the configured public website URL in the p query parameter. The direct
  browser connection also exposes the administrator's public IP address and
  ordinary HTTP connection metadata, including Origin, to the service.
* Not sent: WordPress cookies, login credentials, private posts or editor changes.
  The generator request omits credentials and the Referer header.
* Processing: the service retrieves publicly accessible website content, uses
  its crawler and Ollama backend to create an English llms.txt, and returns it.
  Public content can itself contain personal data; it is part of the crawl.
* Storage: the generator does not cache crawl bodies or results. Its operational
  logs and temporary rate-limit counters can contain IP addresses, website hosts
  and technical error information. WordPress stores only the text you explicitly
  publish and its publication timestamp. Unpublished edits stay in the open tab.
* Limits: the public service has IP, website and overall capacity limits. The
  plugin reports a busy service or a rate limit instead of retrying automatically.

Service information: https://cephei.com/de/llms-generator/
Privacy policy: https://cephei.com/de/datenschutz/
Provider and contact: https://cephei.com/de/impressum/

The browser talks directly to the service so long-running generation does not
depend on PHP execution time limits. A website Content-Security-Policy that
restricts connect-src needs to allow https://llms.cephei.ai. The generator must
send Access-Control-Allow-Origin: * and does not allow credentialed CORS requests.
No per-installation CORS registration is required.

== Installation ==

1. In WordPress, open Plugins > Add New Plugin > Upload Plugin.
2. Upload cephei-llms-txt-generator.zip, install it and activate it.
3. Open Settings > llms.txt Generator.
4. Generate, review and publish your text.
5. Open the displayed /llms.txt link to check the public result.

Use a publicly reachable website for generation. A localhost, private intranet,
password-protected staging site or website blocked against crawlers cannot be
crawled by the public service. You can still enter text manually and test local
publication. A current browser with Fetch streams and AbortSignal.timeout is
required. WordPress requires permission to install plugins; network installations
may require a network administrator for installation.

== Frequently Asked Questions ==

= Does it write a physical file? =

No. The publication is stored in WordPress and served at the virtual /llms.txt URL.
WordPress must handle this URL. Existing files or other plugins can take priority.

= What if /llms.txt already exists? =

Publishing is blocked while a physical llms.txt exists in the website root. To
publish through this plugin, you must first move, rename or delete that file;
keep a backup. The plugin does not overwrite it. Then click Check again in the
notice to unlock publication without reloading or losing the editor text.
The prerequisites are also checked again automatically after successful generation.
These checks only contact your WordPress installation, not the generator.
Disable another plugin's llms.txt feature if it conflicts.
If routing cannot be verified, this plugin does not change its saved publication.
Clear or bypass CDN/page caches for /llms.txt if they hide updates.

= Does it work when WordPress is in a subdirectory? =

WordPress files may be in a subdirectory as long as the public home URL is at the
domain root and root requests are routed to WordPress. If the public home URL is
https://example.com/blog/, this version disables publishing: /blog/llms.txt is
not a substitute for /llms.txt. Hosting or root-site integration is needed.
The same restriction applies to subdirectory sites in a WordPress multisite.

= What happens when I leave the settings page? =

The browser warns about unfinished work. Unpublished edits are not saved as a
draft. Keep the tab open during generation or use Cancel. The last publication
remains unchanged until you explicitly publish again.

= What happens when I deactivate or delete the plugin? =

Deactivation stops the virtual file but keeps the saved publication for later
reactivation. Deleting the plugin removes its stored publication, including
site-specific publications in a multisite network. Export any text you want to
keep first. The plugin does not create a physical file that survives deactivation.

= How do updates work for the blog download? =

This release is distributed as a ZIP. Install a newer ZIP using the WordPress
plugin upload screen to replace it. The publication remains stored. There is no
external auto-updater. The Update URI header prevents accidental replacement by
an unrelated WordPress.org plugin. A future WordPress.org release will migrate
to directory updates.

== Source and license ==

Copyright (C) 2026 Cephei AG.
This plugin is licensed under GNU GPL version 2 or, at your option, any later
version. It is supplied without warranty; see LICENSE.txt.
All PHP, JavaScript and CSS source is included unminified. No runtime build is
needed. German translations are supplied as editable .po and compiled .mo files.
To rebuild the translation with GNU gettext:

msgfmt --check languages/cephei-llms-txt-generator-de_DE.po -o languages/cephei-llms-txt-generator-de_DE.mo

This license applies to the distributed WordPress plugin, not automatically to
the separately operated generator service.

== Changelog ==

= 0.1.3 =
* Rename the Settings menu entry to llms.txt Generator.

= 0.1.2 =
* Simplify the successful recheck message by removing the reference to editor contents.

= 0.1.1 =
* Explain that an existing physical /llms.txt must be removed from that path before publication.
* Add Check again to refresh publication prerequisites without losing editor contents.
* Automatically refresh prerequisites after successful generation.

= 0.1.0 =
* Initial blog-download release.
* Generate, cancel, edit and explicitly publish a virtual /llms.txt.
* Error and completeness checks before removing generator comments.
* Capability and nonce checks, bounded UTF-8 storage and public URL verification.
* English and German settings interfaces.
