1.3.0
Suggest edits and Content to revisit, which find what has gone stale on your published pages and help you fix it; a live preview of every draft through your own templates, with other layouts to choose from and comments you pin on the page; drafts that arrive linked to your other pages, with a search title and description; and Connections, one place to set up every key. Requires 1994/ghostwriter-core ^1.10, Statamic 6.30 or later and PHP 8.3 or later.
Added
- Suggest edits, in the menu beside Edit with Ghostwriter on an existing entry. Free checks look for candidates: a past year written as current ("New for 2024"), "this year" on an old page, a count or claim about you that may have changed ("our team of 6"), a sentence that runs on, a link to a deleted page, an image with no alt text, SEO text over its limit or missing, a heading over 70 characters, and a long page with no links to your other pages. A confirm says what the review costs before anything is sent. The review keeps a candidate only if it's a real problem in its paragraph, adds its own suggestions for voice and clarity, and a second call checks every suggestion again before you see it. The guide shows each change in its sentence, with the reason and where it comes from, and Accept, Edit, Another version, It's still right and Dismiss, with Undo; category filters; Accept all wording fixes; links to your other pages; and alt text saved to the image, after a confirm that says how many pages use it. Accepted words go into the form; nothing is saved but alt text. Decisions are shared and remembered. See Suggest edits.
- Content to revisit (Ghostwriter → Content to revisit, and a tile on the Overview): every published page in the collections Ghostwriter writes for, ranked by free checks (no AI): past years written as current, a closing date that has passed, broken links, images without alt text, empty fields that pages like it fill, unfinished markers, SEO text over its limit, no SEO description, no links to your other pages, heading levels, and age. Tiles filter the list; Review opens a page with Suggest edits ready to run; Snooze for 90 days; a collection filter. Only the collections you can view are listed. It's kept up to date as entries are saved and deleted, and by
php please ghostwriter:revisit, which runs daily at 03:00 on Laravel's scheduler (a full pass weekly). - A weekly check of links to other sites, off by default. Turned on in settings, it runs on Sundays at 04:00: each address at most once a week, one request a second per site, and a link counts as broken after two failed checks in a row.
- Three settings, under Suggest edits and Content to revisit: Check claims and counts (on), Check links to other sites once a week (off) and Count age in full in these dated collections (none). Each can be set in
config/ghostwriter.phpinstead (suggest.claims,revisit.external_links,revisit.age_in_full). - The Preview tab. The draft now has three tabs, Preview | Blocks | Text. Preview shows the unsaved draft rendered through your site's own templates, at Desktop or Phone width, and renders again as the draft changes. Hovering outlines each block with its name. Nothing is saved to show it. A template that fails says why, with Show blocks instead and Try again. Preview pages get headers that keep them private and out of search engines and block third-party scripts. Templates can test
{{ live_preview:ghostwriter }}to leave things out of Ghostwriter's previews. New config:preview.enabled,preview.script_hosts,preview.timeout. See The Preview tab. - Layouts. With a first draft, Ghostwriter offers up to two other layouts of the same words, ranked against your collection's own pages, with the most like them marked Suggested. They show as a row of names above the draft; Compare layouts shows them as cards with a thumbnail of each page. Each says what it changes ("Quote moved up · Text blocks joined"), and choosing one scrolls to and outlines what changed. Only layouts that really differ are offered. The choice is shared with everyone on the piece. See Layouts.
- Extras. The writer prepares stats, FAQs, a pull quote and the like, only for the block types your blueprint has and only from what you gave it. The Text tab lists each with where it came from, and every part can be edited or deleted. See Extras.
- Comments on the page. Turn on Comment above the Preview (Alt+Shift+C), click a block or select words, and write a comment. Comments stay yours, in your browser, until you Apply them: one call revises only the commented blocks, and the reply says what happened to each (Changed, with Before / after and Put it back; Replied; Not applied; or Skipped because someone else changed the block). Comments can be resolved and reopened, follow their words between layouts, and work by keyboard. See Comments.
- Gaps as chips in the draft. In the Preview and the Text tab, a fact to add, a count to check and a link to choose show as small chips instead of raw markers. Click one to deal with it there: type the fact, confirm or change the count, or choose the page to link to. Under plain text fields on the publish form, a row of chips names each gap as you type. The saved entry keeps its markers until they're dealt with.
- Questions before a draft, one box each. When Ghostwriter needs to ask, it lists at most four short questions, each with its own box (or choices), (optional) where it is, and Skip. Send answers, or Just draft it with what you have.
- Model it on picks entries for you. In a collection with no learned kind, the brief now arrives with up to six published entries ticked, the closest in purpose and shape to the new piece. Your own ticks always win.
- Links to your other pages in every first draft. Ghostwriter links a new draft to the most relevant pages of your site (about one link per 250 words, two to five), and a second call checks each one. Links Ghostwriter added are marked in the Text and Blocks tabs, where you can see where each goes and Remove link. Every routed collection and taxonomy term page can be linked to; drafts, noindex pages, utility pages and other sites never are.
- Suggest links in Finish this page: Link to your other pages finds pages to link to on the page as it stands, in the background, and offers each as a step: "Link “…” to Contact us?", Link it or Skip.
- A search title, description and address with the first draft. Ghostwriter writes the page's SEO description, and a search title when the page title is too long, from what the page says. They're in a Search section at the end of the Text tab, editable, with a live character count and Try again. Use this draft puts them into SEO Pro or your plain SEO fields, never over text someone wrote, and fills the slug on a new or unpublished entry. Photo file names are made from the alt text.
- Headings fit your template. Drafts start at H2 under the page's H1, never skip a level, and use only the heading levels each Bard field allows. The Preview reads how your template prints headings, and super users see a note on the Overview when a template prints no H1, or several.
- Finish this page gains: - counts to check: a number Ghostwriter counted from a list you gave ("3 areas") is a step, with Looks right, Change it and Remove it, and blocks publishing like a fact to add; - Shorten a heading for a heading over 70 characters (Write it for me, one small call); - Link to your other pages on a page of 300 words or more with no links to your site; - Add a description for search when the SEO description is empty or too short; - a prompt for an image the page looks like it needs (required, the hero, or one most pages in the collection have).
These suggestions never block publishing, except counts to check.
- Connections (Tools → Ghostwriter → Connections), for managers: a card for every service Ghostwriter uses, under Writing (Anthropic, OpenAI, Gemini, OpenRouter), Images (Unsplash, Pexels, Pixabay, Openverse) and Stock photos (Shutterstock). Set up opens the page where the key is made and takes you through it; Check & save tests the key with one small call before keeping it. Each card says whether it's connected (showing only the key's last four characters), set in
.env, or has stopped working, with Replace key and Disconnect. Connect with OpenRouter and Shutterstock's Connect account are on their cards. A key in.envor config always wins. See Connections. - Keys set up in Connections are encrypted with
APP_KEY, in a newghostwriter_credentialstable (php artisan migrate), or in an encrypted file without a database. IfAPP_KEYchanges, set them up again. - A per-person limit on starting work that calls a model: 30 a minute by default (
rate_limit, orGHOSTWRITER_RATE_LIMIT;0turns it off). - German, French, Dutch and Spanish for the new SEO and Connections wording.
Changed
- The publish guard only acts on what an editor publishes in the Control Panel. Saves from console commands, imports, queued jobs and other addons are never refused. In collections Ghostwriter doesn't write for, it holds back only a stock photo previewed but not licensed, so an old link to a deleted page no longer stops a save there.
- Ghostwriter only reads entries you can view. Learning or suggesting kinds, writing for a collection, and the entries listed under Model it on need Statamic's permission to view that collection's entries; collections you can't view aren't offered.
- Remove preview on the stock images list needs permission to delete assets in the preview's container.
- When a draft's preview fails, only people signed in to use Ghostwriter see the error's details; anyone else with the link sees a plain line.
- One menu beside Edit with Ghostwriter. The "things to finish" and "suggestions" pills are replaced by one count on a menu holding Finish this page, Review suggestions and Suggest edits.
- The writing panel works at every width. Below about 900 px the conversation and the draft are one column, with Conversation | Draft at the top, and nothing in the panel covers anything else. The draft scrolls as one page.
- The writer keeps its own links to real pages instead of turning them into links to choose. For a link it couldn't place, Finish this page suggests the page it most likely means first.
- Better link suggestions: pages are matched by word stems in English, German, French, Dutch and Spanish ("seed" meets "seedheads"), rare words count for more, key pages are always considered, and pages that link to each other or share a category rank higher.
- Finish this page leaves required fields to Statamic's own validation; an empty required field is no longer a step.
- Addresses keep the whole title ("what-to-do-in-the-garden-in-march"); only a title over about 60 characters loses its little words.
- Suggest edits shows only what to act on, never how many things were found fine.
- Settings' API keys section is now a summary linking to Connections. The OpenRouter key and Shutterstock account move into Connections by themselves, and their old files are removed.
Fixed
- Editing an entry in conversation keeps the sets in its Bard fields (images, stats and the like) instead of dropping them.
- Ghostwriter's note to the writer when editing an entry no longer shows in the conversation as if you'd sent it.
- SEO Pro descriptions and titles are read as SEO Pro prints them: the entry, then the collection's defaults, then the site's, including
@seo:fields, Bard sources and noindex. - An entry removed without an event (its file deleted, a deploy) is forgotten by the weekly pass.
- "1 thing still to finish" always opens onto that thing.
- A link to choose whose hint has a space is listed in Finish this page.
- The guide's mark points at the words, not the field, and its words never cover the page's text or run off the window. Long button labels are cut short inside the card.
- Suggest edits' spinner sits beside its words.
- Teach a kind's name box is labelled for screen readers.
Removed
- The Images section under a draft. Use this draft still puts a placeholder in each empty image field, and Finish this page turns each into a step with Find a photo and Choose from Assets. Asking for images in the conversation still works.
Upgrading
bash composer update 1994/ghostwriter-statamic 1994/ghostwriter-core php artisan vendor:publish --tag=ghostwriter-statamic --force php artisan migrate php artisan ghostwriter:revisit --full php artisan queue:restart
migratemakes theghostwriter_credentialstable for Connections. Without a database, skip it: keys are kept in an encrypted file.- Keys in
.envkeep working. The OpenRouter key and Shutterstock account move into Connections by themselves. ghostwriter:revisit --fullbuilds Content to revisit and the link index straight away; otherwise they fill in over the daily pass. Make sure Laravel's scheduler runs (php artisan schedule:runevery minute).- See Upgrading from 1.2 to 1.3.