@goodfellow-cms/admin 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export declare const defaultStrings: {
   readonly "nav.blocks": "Blocks";
   readonly "nav.layout": "Header & Footer";
   readonly "nav.settings": "Site Settings";
+  readonly "nav.menu": "Menu";
   readonly loading: "Loading…";
   readonly "setup.noBackend": "This site's settings don't say where the site is stored, so the admin panel can't open it. A developer needs to add a backend to goodfellow.config.tsx.";
   readonly "signIn.title": "Sign in to edit this site";
@@ -112,11 +113,14 @@ export declare const defaultStrings: {
   readonly "editor.plugin.problemField": "{block}, {field}: {message}";
   readonly "editor.plugin.loading": "Opening {editor}…";
   readonly "editor.plugin.failed": "{editor} didn't start. Choose the standard editor to keep editing.";
+  readonly "editor.invalid": "The editor gave back something this site can't publish, so nothing was published. Reload the page and try again.";
   readonly "editor.plugin.invalid": "{editor} gave back something this site can't publish, so nothing was published. Try again, or choose the standard editor.";
   readonly "publish.publishing": "Publishing…";
   readonly "publish.done": "Published.";
   readonly "publish.conflict": "Someone else changed the site since you opened this page, so your changes weren't published. Reload to see their changes, then make yours again.";
   readonly "publish.error": "Your changes couldn't be published. Check your connection and try again.";
+  readonly "publish.reloaded": "This is the page as the other person left it. Make your changes again, or put yours back to publish them over theirs.";
+  readonly "publish.putMineBack": "Put my changes back";
   readonly "publish.invalid": "Fix the highlighted problems before publishing.";
   readonly "draft.label": "Draft";
   readonly "draft.add": "Add to draft";
@@ -179,6 +183,7 @@ export declare const defaultStrings: {
   readonly "limits.mediaReadOnly": "An owner has limited what you can change, and the media library is outside it. You can still use its files on pages you can change.";
   readonly "checks.missing-page": "{place} links to {target}, which isn't a page on the site.";
   readonly "checks.missing-media": "{place} uses {target}, which isn't in the media library.";
+  readonly "checks.unsafe-link": "{place} links to {target}, an address that would run code on the site. Pages leave it out: use an address that starts with https://, or one of the site's own pages.";
   readonly "checks.no-title": "{place} has no title, so browser tabs and search results show only the site's name.";
   readonly "checks.missing-translation": "{place} has no translation in {language} yet. Visitors reading in {language} are sent to its home page instead.";
   readonly "checks.outdated-translation": "{place} has changed since its translation in {language} was made. Update the translation, then mark it as up to date.";
@@ -479,6 +484,11 @@ export declare const defaultStrings: {
   readonly "blocks.discard": "Discard changes";
   readonly "blocks.publish": "Publish";
   readonly "blocks.publishedNotice": "Published. Added blocks will be in the editor's list of blocks, and removed ones gone from it, once the site has been updated.";
+  readonly "blocks.submit": "Submit for review";
+  readonly "blocks.reviewHint": "Blocks' code runs on this site's server, which holds its secrets, so adding and removing blocks is submitted for review, for a developer to accept.";
+  readonly "blocks.reviewDescription": "From the admin panel's Blocks screen. The blocks' code runs on the site's server.";
+  readonly "blocks.submittedNotice": "Submitted for review. Once a developer accepts it and the site has been updated, the editor's list of blocks will change.";
+  readonly "blocks.seeReview": "See it";
   readonly "blocks.addMessage": "Add the {name} block";
   readonly "blocks.removeMessage": "Remove the {name} block";
   readonly "blocks.changeMessage": "Change blocks: {changes}";
@@ -516,6 +526,7 @@ export declare const defaultStrings: {
   readonly "media.uploaded": "Uploaded. Visitors see new files once the live site is updated.";
   readonly "media.uploadMessage": "Add {names}";
   readonly "media.replaceMessage": "Replace {name}";
+  readonly "media.replaceKind": "{name} is a different kind of file from {target}. Replace it with a file of the same kind, or upload {name} as a new file.";
   readonly "media.deleteMessage": "Delete {name}";
   readonly "media.deleteTitle": "Delete {name}?";
   readonly "media.deleteBody": "{name} will be removed from the site.";
@@ -573,6 +584,12 @@ export declare const defaultStrings: {
   readonly "style.allSides": "All sides";
   readonly "style.none": "None";
   readonly "style.radius": "Rounded corners";
+  readonly "style.hiddenOn": "Hide on";
+  readonly "style.hiddenOn.phones": "Phones (narrower than 640px)";
+  readonly "style.hiddenOn.tablets": "Tablets (640px to 1023px)";
+  readonly "style.hiddenOn.computers": "Computers (1024px and wider)";
+  readonly "style.hiddenOnHint": "Choose a preview width above the page to see it as each size of screen does. A block hidden there is still in the Outline, where you can choose it.";
+  readonly "style.hiddenOnAll": "This block is hidden on every size of screen, so visitors never see it.";
   readonly "style.radius.none": "Square";
   readonly "style.radius.sm": "Slightly rounded";
   readonly "style.radius.md": "Rounded";
@@ -677,10 +694,8 @@ export declare const defaultStrings: {
   readonly "ai.error.answer": "The answer couldn't be used. Try again, or try a different model or service.";
   readonly "ai.error.service": "{service} reported a problem. Try again in a moment.";
   readonly "settings.title": "Site Settings";
-  readonly "appearance.choice": "Colors of the admin panel";
-  readonly "appearance.system": "Match my computer";
-  readonly "appearance.light": "Light";
-  readonly "appearance.dark": "Dark";
+  readonly "appearance.darkMode": "Dark mode";
+  readonly "adminLanguage.label": "Language of the admin panel";
   readonly "settings.tab.general": "General";
   readonly "settings.tab.languages": "Languages";
   readonly "settings.tab.theme": "Colors & fonts";
@@ -796,6 +811,7 @@ export declare const defaultStrings: {
   readonly "security.contentOnly": "The sign-in page is set in the site's code, which is kept apart from its content, so a developer sets it there.";
   readonly "security.broker.title": "Sign-in page";
   readonly "security.broker.intro": "A sign-in page of its own, called a token broker, keeps editors' sign-in and AI keys at an address that holds nothing else, and shows the admin panel from there, so nothing on the site's pages can reach them. It asks the editor before publishing the site's code. It needs an address of its own, such as signin.example.org, that serves nothing else.";
+  readonly "security.exposed": "Editors sign in at the site's own address, where its pages could reach their sign-in: code added on the Code tab, or by a block, could act as anyone signed in. A sign-in page of its own, below, keeps it out of their reach, and needs no domain on GitLab, Cloudflare Pages or Vercel. Where you have a domain and the host allows it, an admin address of its own, on the Domain screen, does too.";
   readonly "security.broker.useTitle": "Sign in at a sign-in page that's online";
   readonly "security.add.title": "Add a token broker";
   readonly "security.add.intro": "Makes a project on {host} for the sign-in page, from Goodfellow's released files and a file naming this site, and puts it online where you choose. It needs a token that can create projects, used only now and kept only until you leave this screen.";
@@ -868,6 +884,74 @@ export declare const defaultStrings: {
   readonly "settings.tab.editors": "Editors";
   readonly "settings.tab.updates": "Updates";
   readonly "settings.tab.history": "Site history";
+  readonly "settings.tab.comments": "Comments";
+  readonly "comments.intro": "Visitors' comments are kept on GitHub, in a public project of their own, and shown on pages with the Comments block through Giscus. Visitors sign in with a GitHub account to comment.";
+  readonly "comments.demo": "Comments can't be set up in the demo.";
+  readonly "comments.local": "Comments are set up from the admin panel on the live site, which signs in to GitHub. Pages here show them once they are.";
+  readonly "comments.unavailable": "The admin panel can set comments up only where it signs in to GitHub itself. Set them up on GitHub as the documentation's Comments page says, then paste Giscus's code into the Comments block.";
+  readonly "comments.setup.title": "Set up comments";
+  readonly "comments.setup.new": "Make a new project for comments";
+  readonly "comments.setup.existing": "Use a project I already have";
+  readonly "comments.setup.name": "Name of the new project";
+  readonly "comments.setup.nameHint": "It's made beside the site's own on GitHub. Anyone can read it, since visitors read the comments from there.";
+  readonly "comments.setup.existingName": "The project, as owner/name or its address on GitHub";
+  readonly "comments.setup.existingHint": "It must be public. Its Discussions are turned on if they're off.";
+  readonly "comments.setup.button": "Set up comments";
+  readonly "comments.setup.working": "Setting up…";
+  readonly "comments.setup.description": "Visitors' comments on {site}";
+  readonly "comments.setup.message": "Set up comments";
+  readonly "comments.install.title": "Last step: install Giscus";
+  readonly "comments.install.intro": "Giscus is the GitHub app that shows comments on pages and posts what visitors write. Install it on {project}, choosing only that project.";
+  readonly "comments.install.button": "Install Giscus";
+  readonly "comments.install.then": "Then add the Comments block to a page, or to a collection's template. Pages show comments once the site has been rebuilt.";
+  readonly "comments.place.title": "Where comments are kept";
+  readonly "comments.place.kept": "Comments are kept as {category} discussions in";
+  readonly "comments.place.install": "If pages don't show comments, check that Giscus is installed on the project:";
+  readonly "comments.place.giscus": "Giscus on GitHub";
+  readonly "comments.stop.button": "Stop using comments";
+  readonly "comments.stop.title": "Stop using comments?";
+  readonly "comments.stop.body": "Pages stop showing comments once the site has been rebuilt. Everything visitors wrote stays in {project} on GitHub, so you can set comments up with it again later.";
+  readonly "comments.stop.message": "Stop using comments";
+  readonly "comments.moderate.title": "What visitors have written";
+  readonly "comments.moderate.empty": "No one has commented yet.";
+  readonly "comments.moderate.more": "Show more pages";
+  readonly "comments.moderate.block": "To stop someone commenting at all, block them on GitHub.";
+  readonly "comments.moderate.blockLink": "How to block someone";
+  readonly "comments.thread.count": "Comments: {count}";
+  readonly "comments.thread.locked": "Closed to new comments";
+  readonly "comments.thread.lock": "Close to new comments";
+  readonly "comments.thread.unlock": "Open to new comments";
+  readonly "comments.openOnGitHub": "Open on GitHub";
+  readonly "comments.comment.hidden": "Hidden";
+  readonly "comments.comment.hiddenAs": "Hidden as {reason}";
+  readonly "comments.comment.hide": "Hide";
+  readonly "comments.comment.show": "Show again";
+  readonly "comments.comment.delete": "Delete";
+  readonly "comments.hide.title": "Hide this comment?";
+  readonly "comments.hide.body": "It stays on the page, folded away and marked with why it was hidden, until you show it again.";
+  readonly "comments.hide.reason": "Why";
+  readonly "comments.reason.spam": "spam";
+  readonly "comments.reason.abuse": "abusive";
+  readonly "comments.reason.off-topic": "off topic";
+  readonly "comments.delete.title": "Delete this comment?";
+  readonly "comments.delete.body": "It's removed for good.";
+  readonly "comments.delete.bodyReplies": "It's removed for good, with the replies to it.";
+  readonly "comments.token.title": "Use a GitHub token for comments";
+  readonly "comments.token.intro": "The admin panel's sign-in can reach only the site's own project on GitHub. To set up and moderate comments, use a GitHub token of your own. It's kept only in this tab, until you sign out.";
+  readonly "comments.token.create": "Create a token on GitHub";
+  readonly "comments.token.scope": "It's filled in with what comments need: leave the choices as they are.";
+  readonly "comments.token.paste": "Copy the token and paste it here:";
+  readonly "comments.token.label": "GitHub token";
+  readonly "comments.token.active": "This tab is using a GitHub token of your own for comments.";
+  readonly "comments.error.no-access": "GitHub didn't let this sign-in do that. Use a GitHub token of your own, made by someone who can manage the project.";
+  readonly "comments.error.not-found": "GitHub has no project with that name, or this sign-in can't see it.";
+  readonly "comments.error.not-public": "That project is private, so visitors couldn't read its comments. Make it public on GitHub, then try again.";
+  readonly "comments.error.name-taken": "There's already a project with that name. Choose another name, or use it as a project you already have.";
+  readonly "comments.error.name-invalid": "A project's name can have only letters, numbers, hyphens, underscores and dots.";
+  readonly "comments.error.no-discussions": "Discussions are off in that project, and this sign-in can't turn them on. Turn them on in the project's settings on GitHub, then try again.";
+  readonly "comments.error.no-category": "That project's Discussions have no categories yet. Open its Discussions on GitHub once, then try again.";
+  readonly "comments.error.other": "Something went wrong on GitHub. Try again in a moment.";
+  readonly "comments.error.fix": "Open it on GitHub";
   readonly "settings.tab.import": "WordPress";
   readonly "settings.tab.themes": "Themes";
   readonly "plugins.notFound": "The site has no plugin screen at this address.";
@@ -1338,6 +1422,25 @@ export declare const defaultStrings: {
   readonly "forms.accessKeyLink": "Get an access key from Web3Forms";
   readonly "forms.captcha": "Ask visitors to show they aren't robots (hCaptcha)";
   readonly "forms.captchaHint": "Adds Web3Forms' hCaptcha and its script to pages with a form. To turn away answers without it, also turn hCaptcha on for the form in a Web3Forms account.";
+  readonly "consent.title": "Visitors' consent";
+  readonly "consent.ask": "Ask visitors before showing content from other sites";
+  readonly "consent.hint": "Videos from YouTube and Vimeo, Google forms and maps, hCaptcha and the code under Code wait until visitors agree, with a notice at the bottom of the page that asks them. Their answer is kept in their browser. Links to #consent, such as in a menu, open the notice again.";
+  readonly "consent.message": "What the notice says";
+  readonly "consent.accept": "Button that agrees";
+  readonly "consent.decline": "Button that doesn't";
+  readonly "consent.held": "What's shown in a video's or form's place";
+  readonly "consent.heldHint": "{site} is where it comes from, such as youtube-nocookie.com.";
+  readonly "consent.show": "Button there that shows it";
+  readonly "consent.policy": "Privacy page";
+  readonly "consent.policyHint": "The page that says what the site and the sites it shows content from do, such as /privacy.";
+  readonly "consent.policyLabel": "Words of the link to it";
+  readonly "consent.choose": "Button that shows the choices";
+  readonly "consent.save": "Button that keeps the choices";
+  readonly "consent.kind.content": "Choice for content from other sites";
+  readonly "consent.kind.statistics": "Choice for statistics";
+  readonly "consent.kind.marketing": "Choice for advertising";
+  readonly "consent.days": "Ask again after this many days";
+  readonly "consent.daysHint": "Visitors' answers last this long, then the notice asks again. 180 days, about six months, is common; regulators in Europe accept up to 395, 13 months.";
   readonly "forms.formspree": "Formspree form address";
   readonly "forms.formspreeHint": "Make a form in Formspree and copy its address, such as https://formspree.io/f/xyzabcde. On Formspree's free plan, visitors see Formspree's own thank-you page.";
   readonly "forms.address": "Address forms send answers to";
@@ -1456,13 +1559,23 @@ export declare const defaultStrings: {
   readonly "css.label": "Custom CSS";
   readonly "code.editorHint": "Tab indents, and suggestions appear as you type. Press Escape, then Tab, to leave the editor. Ctrl+F finds and replaces.";
   readonly "code.intro": "Code from services such as analytics or site verification, added to every page of the site. It never runs in the admin panel, so check it on the site once it's published. Paste only code you trust: it can change anything on the site.";
+  readonly "code.exposed": "Editors sign in at the same address as the site's pages, so code here runs where it could act as anyone signed in to the admin panel, and publish changes as them.";
+  readonly "code.exposedFix": "A sign-in page or an admin address of its own, on the Security tab, keeps their sign-in out of its reach.";
   readonly "code.head": "In the page head";
   readonly "code.headHint": "Script, style, link, meta and noscript tags, such as the ones Google Analytics gives you.";
+  readonly "code.purpose.head": "What the code in the page head is for";
+  readonly "code.purpose.body": "What the code at the end of the page is for";
+  readonly "code.purposeHint": "Visitors choose which kinds to allow. Code needed for the site to work loads for everyone without asking, so choose it only for code that doesn't follow visitors.";
+  readonly "code.purpose.needed": "Needed for the site to work: loads without asking";
+  readonly "code.purpose.content": "Content from other sites, such as a chat widget";
+  readonly "code.purpose.statistics": "Statistics, such as Google Analytics";
+  readonly "code.purpose.marketing": "Advertising";
   readonly "code.body": "At the end of the page";
   readonly "code.bodyHint": "Any HTML, such as a chat widget, added just before the end of every page.";
   readonly "code.error.text": 'The code in the page head has text outside a tag: "{text}". Only tags such as <script> and <meta> can go there.';
   readonly "code.error.tag": 'A <{tag}> tag can\'t go in the page head. Put it in "At the end of the page" instead.';
   readonly "code.error.unclosed": "A {tag} tag in the page head isn't closed.";
+  readonly "code.error.template": "This code has </template> in it. While the site asks visitors before loading other sites' content, that would let the code run before they agree. Take it out.";
 };
 type StringKey = keyof typeof defaultStrings;
 type Strings = Record<StringKey, string>;
@@ -1534,7 +1647,7 @@ interface AdminProps {
   registry?: string;
 }
 /** The admin panel. Render it on its own page, such as `/admin`. */
-export declare function Admin({ site, frames, store, host, server, preview, siteUrl, strings, registry }: AdminProps): import("react").JSX.Element;
+export declare function Admin({ site, frames, store, host, server, preview, siteUrl, strings, registry }: AdminProps): import("react").JSX.Element | null;
 /** Renders the admin panel into an element. */
 export declare function mountAdmin(element: Element, props: AdminProps): void;
 //#endregion