@aglyn/aglyn 1.15.1 → 1.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -5763,14 +5763,14 @@ export const DOCS_SECTION_INDEX = [
5763
5763
  title: 'Quotes',
5764
5764
  heading: 'What a quote holds',
5765
5765
  anchor: '#what-a-quote-holds',
5766
- text: '- The customer. When your workspace keeps contacts, find someone by name, email or phone; or type their name, company, email and phone. A contact keeps the quote tied to their record.\n- Items. Any mix of:\n- Products from your catalog, with the option you pick and any add-ons the product offers. They are priced from the product, add-ons included, exactly as the point of sale prices them.\n- Custom items, typed for this job: a name, an optional description and SKU, a unit price and a quantity. Turn off Ships for work that doesn\'t ship, such as design or installation. A custom item never changes your stock.\n- Included items. Turn on Included at no charge for anything that comes with the order, a product or a custom item, and it is listed at no charge.\n- Discount: an amount off, or a percent off the items.\n- Shipping: the amount you charge to ship it. Leave it empty when nothing ships.\n- Ship to and Bill to addresses.\n- Notes for the customer and Terms.\nEach quote also keeps whether Customers approve the proof before they can pay. When it is on and the quote has a proof the customer hasn\'t approved, the customer\'s page asks them to approve it instead of offering Pay, and a payment can\'t be started for it. A quote with no proof is never held. See Proof approval and paying.'
5766
+ text: '- The customer. When your workspace keeps contacts, find someone by name, email or phone; or type their name, company, email and phone. A contact keeps the quote tied to their record.\n- Items. Any mix of:\n- Products from your catalog, with the option you pick and any add-ons the product offers. They are priced from the product, add-ons included, exactly as the point of sale prices them.\n- Custom items, typed for this job: a name, an optional description and SKU, a unit price and a quantity. Turn off Ships for work that doesn\'t ship, such as design or installation. A custom item never changes your stock.\n- Included items. Turn on Included at no charge for anything that comes with the order, a product or a custom item, and it is listed at no charge.\n- Discount: an amount off, or a percent off the items.\n- Shipping: the amount you charge to ship it. Leave it empty when nothing ships.\n- Ship to and Bill to addresses.\n- Notes for the customer and Terms.\nEach quote also keeps whether Customers approve the proof before they can pay. When it is on and the quote has a proof the customer hasn\'t approved, the customer\'s page asks them to approve it instead of offering Pay, and a payment can\'t be started for it. A quote with no proof is never held. See Proof approval and paying.\nEach quote also keeps whether Customers sign in to see and approve proofs. See Who can open a proof.'
5767
5767
  },
5768
5768
  {
5769
5769
  path: '/commerce-and-bookings/commerce/quotes-and-proofs',
5770
5770
  title: 'Quotes',
5771
5771
  heading: 'New-quote defaults',
5772
5772
  anchor: '#quote-defaults',
5773
- text: 'The Quotes card on the Checkout settings page sets what every new quote starts with: whether customers approve the proof before they can pay. Turn the switch on or off and choose Save. Each quote starts with this setting, and you can change it on the quote.'
5773
+ text: 'The Quotes card on the Checkout settings page sets what every new quote starts with:\n- Customers approve the proof before they can pay (see Proof approval and paying);\n- Customers sign in to see and approve proofs (see Who can open a proof).\nTurn a switch on or off and choose Save. Each new quote starts with these settings, and you can change them on the quote.\nThe same card holds Before a customer approves a proof: the statements your customer ticks before Approve works. It starts with three suggestions:\n- I checked the spelling, names and numbers.\n- I checked the colors, sizes and placement.\n- I understand production starts when I approve, and changes after that may cost extra.\nChange the wording to suit your work, add up to five, or remove the ones you don\'t need (at least one stays). Use the suggested statements puts the three back. Choose Save. The statements apply to every quote from then on, including ones already sent: a customer who opened the page before you changed them is asked to look again.'
5774
5774
  },
5775
5775
  {
5776
5776
  path: '/commerce-and-bookings/commerce/quotes-and-proofs',
@@ -5784,7 +5784,7 @@ export const DOCS_SECTION_INDEX = [
5784
5784
  title: 'Quotes',
5785
5785
  heading: 'A Request a quote form',
5786
5786
  anchor: '#a-request-a-quote-form',
5787
- text: 'Let customers ask for a quote on your site, with the product they want and their artwork:\n1. On the Forms page, make a form (or open one) and open it in the Besigner.\n2. Add the fields you need: a name, an email, a message, a Product and options field from the element picker\'s Forms group, and a File upload field for logos or artwork.\n3. On the form\'s page, under After someone sends it, turn on This form asks for a quote. Email the person a confirmation turns on with it.\n4. Publish the form and place it on a page.\nThe Product and options field lists your store\'s products for the customer to pick from, then the product\'s options (size, color and so on). To quote one product only, pick it in the field\'s Product setting; the customer then picks just its options. The field sends the product and options in words, which is what your Inbox and your alert show, and keeps the exact product and option beside them for the quote.\nThe customer gets a confirmation email with a copy of their request, and their request lands in your Inbox marked Quote request.'
5787
+ text: 'Let customers ask for a quote on your site, with the product they want and their artwork:\n1. On the Forms page, make a form (or open one) and open it in the Besigner.\n2. Add the fields you need: a name, an email, a message, a Product and options field from the element picker\'s Forms group, and a File upload field for logos or artwork.\n3. On the form\'s page, under After someone sends it, turn on This form asks for a quote. Email the person a confirmation turns on with it.\n4. Publish the form and place it on a page.\nThe Product and options field lists your store\'s products for the customer to pick from, then the product\'s options (size, color and so on). To quote one product only, pick it in the field\'s Product setting; the customer then picks just its options. The field sends the product and options in words, which is what your Inbox and your alert show, and keeps the exact product and option beside them for the quote.\nInside a Product detail block, the field doesn\'t ask again: it takes the product, options, add-ons and quantity the customer picked on the page. See A free mockup before they buy.\nThe customer gets a confirmation email with a copy of their request, and their request lands in your Inbox marked Quote request.'
5788
5788
  },
5789
5789
  {
5790
5790
  path: '/commerce-and-bookings/commerce/quotes-and-proofs',
@@ -5812,14 +5812,14 @@ export const DOCS_SECTION_INDEX = [
5812
5812
  title: 'Quotes',
5813
5813
  heading: 'Email the quote',
5814
5814
  anchor: '#send',
5815
- text: 'Send the quote to your customer by email, from your site, with your own message:\n1. Open a saved quote and choose Send quote under Email to customer.\n2. Check To. It starts with the customer\'s email from the quote; type another address to send it somewhere else.\n3. Check Subject. It starts as Quote #1042 from your business name.\n4. Type a Message: a few words to your customer, shown at the top of the email.\n5. Choose Send.\nThe quote then shows Sent with the date and the address, and moves to Sent in the list (unless your customer has already approved it or asked for changes, which it keeps showing). The email shows the quote as it was last saved, so save your changes first.'
5815
+ text: 'Send the quote to your customer by email, from your site, with your own message:\n1. Open a saved quote and choose Send quote under Email to customer.\n2. Check To. It starts with the customer\'s email from the quote; type another address to send it somewhere else.\n3. Check Subject. It starts as Quote #1042 from your business name.\n4. Type a Message: a few words to your customer, shown at the top of the email.\n5. Choose Send.\nThe quote then shows Sent with the date and the address, and moves to Sent in the list (unless your customer has already approved it or rejected it with changes, which it keeps showing). The email shows the quote as it was last saved, so save your changes first.'
5816
5816
  },
5817
5817
  {
5818
5818
  path: '/commerce-and-bookings/commerce/quotes-and-proofs',
5819
5819
  title: 'Quotes',
5820
5820
  heading: 'What your customer gets',
5821
5821
  anchor: '#quote-email',
5822
- text: 'One email in your site\'s look, from your site\'s name, with:\n- Your quote from your business name as its heading, or Your updated quote when it\'s a new revision of a quote you already emailed (the first email you send for a quote, and sending the same revision again, keep Your quote from);\n- your message;\n- the quote number, its revision and its total;\n- the first three proof images, each opening the quote page, and the other proof files by name, to see on the quote page (a WebP image is named rather than shown, because some inboxes can\'t show one);\n- what to do next, and one button:\n- Review and approve while the proof must be approved before paying and isn\'t yet;\n- otherwise View and pay with the total;\n- the quote attached as a PDF, the same one as Download PDF, with the pay link on it.\nThe button opens the quote\'s pay link. Replies go to the Email in your site\'s Business details, and to your own email when your site has none. The email ends with a line saying so.\nA proof with no price yet goes out as a proof: Your proof from your business name as its heading, no total, no PDF, and a Review the proof button.\nThe email is the Quote email under Emails, where you can change its wording and colors like your other site emails. It can use these tokens:\n| Token | Value |\n| -- | -- |\n| {{quote.label}} | Quote, or Proof for a proof with no price yet |\n| {{quote.number}}, {{quote.revision}}, {{quote.total}} | The quote number, like #1042, its revision, and its total (with "before tax" when Stripe Tax adds the tax at payment; empty for a proof with no price yet) |\n| {{quote.heading}}, {{quote.intro}} | The heading, and one sentence on whether this is a new quote or an updated revision |\n| {{quote.message}} | The message you typed; empty when you typed none |\n| {{quote.proofImage'
5822
+ text: 'One email in your site\'s look, from your site\'s name, with:\n- Your quote from your business name as its heading, or Your updated quote when it\'s a new revision of a quote you already emailed (the first email you send for a quote, and sending the same revision again, keep Your quote from);\n- your message;\n- the quote number, its revision and its total;\n- the first three proof images, each opening the quote page, and the other proof files by name, to see on the quote page (a WebP image is named rather than shown, because some inboxes can\'t show one);\n- what to do next (approving means confirming they checked the proof and typing their name), and one button:\n- Review and approve while the proof must be approved before paying and isn\'t yet;\n- otherwise View and pay with the total;\n- the quote attached as a PDF, the same one as Download PDF, with the pay link on it.\nThe button opens the quote\'s pay link. Replies go to the Email in your site\'s Business details, and to your own email when your site has none. The email ends with a line saying so.\nWhen the quote asks a customer with an account to sign in and your customer has one, the email shows no proof images, since an inbox isn\'t signed in to your site. It names the proof files and asks your customer to sign in on the quote page to see them.\nA proof with no price yet goes out as a proof: Your proof from your business name as its heading, no total, no PDF, and a Review the proof button.\nThe email is the Quote email under Emails, where you can change its wording and colors like your other site emails. It can use these tokens:\n| Token | Value |\n| -- | -- |\n| {{quote.label}} | Quote, or Proof for a proof with no price yet |\n| {{quote.number}}, {{quote.revision}}, {{quote.total}} | The quote number, like #1042, its revision, and '
5823
5823
  },
5824
5824
  {
5825
5825
  path: '/commerce-and-bookings/commerce/quotes-and-proofs',
@@ -5854,35 +5854,49 @@ export const DOCS_SECTION_INDEX = [
5854
5854
  title: 'Quotes',
5855
5855
  heading: 'Attach proofs',
5856
5856
  anchor: '#proofs',
5857
- text: 'A proof shows your customer what they\'re getting before you make it: the canopy with their logo on it, the sign laid out at size. Attach proofs to a saved quote, and your customer sees them on the quote page, where they approve them or ask for changes.\n1. Open the quote and find Proofs in the editor.\n2. Choose Add proof and pick one or more files from your device, or choose From media library and pick a file you keep there.\nFrom media library offers the files you can read in this site\'s library and in your workspace\'s shared library, including private ones. The quote keeps its own private copy, made the moment you choose the file, so changing or deleting the file in the library afterward doesn\'t change what your customer sees or approved. A library file that isn\'t private still has its own public address in the library. To keep a design off the web entirely, turn on Private for it there too.\nA proof can be a PNG, JPEG, WebP, GIF, PDF, SVG, AI, EPS, PSD or TIFF file, up to 25 MB each, and a revision holds up to 10. Images show as pictures, and the other files as a chip with the file\'s name and size. Choose a picture or a chip to download the file.\nEvery file is checked before it\'s kept: a file whose contents aren\'t what its name says, or that carries a program, isn\'t taken, and an SVG is stripped of anything that could run. Proofs are kept privately with the quote. Only your team and the holder of the quote\'s link can open them, and never through a public address.\nTo take a proof off, choose Remove under it. You can add and remove proofs until your customer answers. After that, start a new revision to send different proofs. A proof with no price yet keeps its last proof until it has another.\nProofs, and the files your customer sends with an answer, count toward your work'
5857
+ text: 'A proof shows your customer what they\'re getting before you make it: the canopy with their logo on it, the sign laid out at size. Attach proofs to a saved quote, and your customer sees them on the quote page, where they approve them or reject them with changes.\n1. Open the quote and find Proofs in the editor.\n2. Choose Add proof and pick one or more files from your device, or choose From media library and pick a file you keep there.\nFrom media library offers the files you can read in this site\'s library and in your workspace\'s shared library, including private ones. The quote keeps its own private copy, made the moment you choose the file, so changing or deleting the file in the library afterward doesn\'t change what your customer sees or approved. A library file that isn\'t private still has its own public address in the library. To keep a design off the web entirely, turn on Private for it there too.\nA proof can be a PNG, JPEG, WebP, GIF, PDF, SVG, AI, EPS, PSD or TIFF file, up to 25 MB each, and a revision holds up to 10. Images show as pictures, and the other files as a chip with the file\'s name and size. Choose a picture or a chip to download the file.\nEvery file is checked before it\'s kept: a file whose contents aren\'t what its name says, or that carries a program, isn\'t taken, and an SVG is stripped of anything that could run. Proofs are kept privately with the quote. Only your team and the holder of the quote\'s link can open them, and never through a public address.\nTo take a proof off, choose Remove under it. You can add and remove proofs until your customer answers. After that, start a new revision to send different proofs. A proof with no price yet keeps its last proof until it has another.\nProofs, and the files your customer sends with an answer, count toward '
5858
5858
  },
5859
5859
  {
5860
5860
  path: '/commerce-and-bookings/commerce/quotes-and-proofs',
5861
5861
  title: 'Quotes',
5862
5862
  heading: 'Send a proof before it has a price',
5863
5863
  anchor: '#proof-only',
5864
- text: 'A design often goes out before it\'s priced. A quote with a proof and no items is Proof only: you send your customer a link to the proof, and only someone with that link can open it, with no account.\n1. On the Orders tab, choose New quote in the Quotes card, and fill in the customer.\n2. Under Proofs, choose From media library and pick the design. Add more if you have them.\n3. Leave the items empty, and choose Create proof.\n4. Open it in the list, then choose Send proof, or Copy proof link to send the link yourself.\nYour customer sees the proof with Approve this proof and Request changes, and no items, totals, Pay or PDF. The email they get says the same.\nAdd an item and choose Save whenever you\'re ready to price it. It\'s then a normal quote on the same link, with its total and Pay, and an approval they already gave still stands. Taking every item off a quote with a proof makes it proof only again; a quote with no items and no proof can\'t be saved.\nA proof only quote has no invoice and no Download PDF, and starting a new revision works as it does for any quote. Until the new revision has a proof, it can\'t be emailed, and the link tells your customer the next version is on its way.'
5864
+ text: 'A design often goes out before it\'s priced. A quote with a proof and no items is Proof only: you send your customer a link to the proof, and only someone with that link can open it, with no account.\n1. On the Orders tab, choose New quote in the Quotes card, and fill in the customer.\n2. Under Proofs, choose From media library and pick the design. Add more if you have them.\n3. Leave the items empty, and choose Create proof.\n4. Open it in the list, then choose Send proof, or Copy proof link to send the link yourself.\nYour customer sees the proof with Approve this proof and Reject with changes, and no items, totals, Pay or PDF. The email they get says the same.\nAdd an item and choose Save whenever you\'re ready to price it. It\'s then a normal quote on the same link, with its total and Pay, and an approval they already gave still stands. Taking every item off a quote with a proof makes it proof only again; a quote with no items and no proof can\'t be saved.\nA proof only quote has no invoice and no Download PDF, and starting a new revision works as it does for any quote. Until the new revision has a proof, it can\'t be emailed, and the link tells your customer the next version is on its way.'
5865
5865
  },
5866
5866
  {
5867
5867
  path: '/commerce-and-bookings/commerce/quotes-and-proofs',
5868
5868
  title: 'Quotes',
5869
5869
  heading: 'What your customer sees of the proofs',
5870
5870
  anchor: '#customer-proofs',
5871
- text: 'When the current revision has proofs, the quote page shows them under the quote: each image as a picture and every other file as a download. Beside them are two choices:\n- Approve this proof. Your customer types their name and chooses Approve. The quote keeps their name, the time, and the address and browser it came from, as the record of the approval, and moves to Approved.\n- Request changes. Your customer says what should change, and can attach their own artwork: up to 10 files of the same kinds and size as proofs. The quote moves to Changes requested, with their comment and files. Files they attach and never send are deleted a day later.\nThe latest answer is the one that counts. A customer who asked for changes can still approve, and one who approved can still ask for changes, which withdraws the approval. The page tells them what they last said.\nYou\'re notified of every answer, in the console and by email, as Proof approved or Changes requested, with the quote, the customer, the revision, the quote\'s total (if it has one) and what they said. View quote opens the quote, and replying to the email reaches your customer. These notices follow your settings for order notifications.\nA paid quote still shows its proofs, with nothing to press. A link you replaced shows nothing of the quote, proofs included, and takes no answer.'
5871
+ text: 'When the current revision has proofs, the quote page shows them under the quote: each image as a picture and every other file as a download. Beside them are two choices:\n- Approve this proof. Your customer ticks each statement you set on the Quotes card, such as "I checked the spelling, names and numbers", types their name and chooses Approve. Approve stays off until every box is ticked and a name is typed, and an approval that skips one is refused. The quote keeps their name, the statements they confirmed, the time, and the address and browser it came from, as the record of the approval, and moves to Approved. You see the record under Proofs on the quote, and your customer sees it on the page.\n- Reject with changes. Your customer says what should change and types their name, and can attach their own artwork: up to 10 files of the same kinds and size as proofs. What to change and the name are required; files are optional, and the statements they confirm for an approval don\'t apply. The quote records the revision as rejected, with their note, name, files and the time, and moves to Rejected with changes. Files they attach and never send are deleted a day later.\nThe latest answer is the one that counts. A customer who rejected a proof with changes can still approve it, and one who approved can still reject it with changes, which withdraws the approval. The page tells them what they last said.\nYou\'re notified of every answer, in the console and by email, as Proof approved or Rejected with changes, with the quote, the customer, the revision, the quote\'s total (if it has one) and what they said: the statements they confirmed when they approved, or their note, name and the names of any files when they rejected it. View quote opens the quote, and replying to the email reaches y'
5872
+ },
5873
+ {
5874
+ path: '/commerce-and-bookings/commerce/quotes-and-proofs',
5875
+ title: 'Quotes',
5876
+ heading: 'Who can open a proof',
5877
+ anchor: '#proof-sign-in',
5878
+ text: 'A proof opens from the quote\'s private link, so anyone your customer forwards the link to can see it and answer it. When that\'s not what you want, turn on Customers sign in to see and approve proofs on the quote (the new-quote default sets where each quote starts):\n- Your customer has an account on your site (they signed up under the email on the quote): the quote page shows the quote but not the proof, with a Sign in button. Once they sign in to that account, the page shows the proof and they can approve it or reject it with changes. Someone signed in to a different account is asked to sign in with the right one. The proof\'s files, approving and asking for changes all check the sign-in, not only the page.\n- Your customer has no account (a phone or walk-in customer, say): the private link works as it always has. Replace link on the quote still shuts off a link that went to the wrong person.\n- Off: the private link is enough for everyone.\nYour site needs User Accounts switched on for a customer to have an account; on a site without them every customer uses the link. Nothing about the link expires or needs opening or closing. Paying never needs a sign-in.'
5879
+ },
5880
+ {
5881
+ path: '/commerce-and-bookings/commerce/quotes-and-proofs',
5882
+ title: 'Quotes',
5883
+ heading: 'Messages with your customer',
5884
+ anchor: '#messages',
5885
+ text: 'A quote keeps its own conversation with your customer, under Messages on the quote. It stays with the quote through every revision and after it\'s paid.\n- Reply from the quote. Write in Messages and choose Send reply. It\'s emailed to the customer\'s email on the quote (or where you last emailed the quote) from your site, in the same email conversation as the quote emails, with a View your quote button. The reply is listed under Messages with who sent it. Sending a reply needs Send quotes and invoices to customers; anyone who edits quotes can read the conversation.\n- Your customer writes on the quote page. Under Messages on the quote page, your customer writes to you and chooses Send message. It\'s listed on the quote, and you\'re notified in Aglyn and by email as Customer message, with what they wrote and a View quote button. Replying to that email reaches your customer.\n- Your customer replies by email. Their email answer goes to your site\'s contact email (or yours, if the site has none), like an answer to an Inbox reply. It doesn\'t appear under Messages: Aglyn doesn\'t receive email.\nThe reply email is the Quote message email under Emails, where you can change its wording and colors like your other site emails. Your customer\'s page shows what each of you wrote, never an email address or who on your team sent it. When the quote asks a customer with an account to sign in and the quote has a proof, Messages on the quote page waits on the same sign-in.'
5872
5886
  },
5873
5887
  {
5874
5888
  path: '/commerce-and-bookings/commerce/quotes-and-proofs',
5875
5889
  title: 'Quotes',
5876
5890
  heading: 'Proof approval and paying',
5877
5891
  anchor: '#approval-and-paying',
5878
- text: 'Whether paying waits on the approval is up to you, quote by quote, with Customers approve the proof before they can pay (the new-quote default sets where each quote starts):\n- On: while the current revision has a proof your customer hasn\'t approved, the quote page shows a short line asking them to approve it in place of Pay, and no payment can be started. Approving brings Pay back. A new revision with new proofs needs its own approval.\n- Off: Pay is always there. Your customer can approve or ask for changes, and paying never waits on it.'
5892
+ text: 'Whether paying waits on the approval is up to you, quote by quote, with Customers approve the proof before they can pay (the new-quote default sets where each quote starts):\n- On: while the current revision has a proof your customer hasn\'t approved, the quote page shows a short line asking them to approve it in place of Pay, and no payment can be started. Approving brings Pay back. A new revision with new proofs needs its own approval.\n- Off: Pay is always there. Your customer can approve or reject with changes, and paying never waits on it.'
5879
5893
  },
5880
5894
  {
5881
5895
  path: '/commerce-and-bookings/commerce/quotes-and-proofs',
5882
5896
  title: 'Quotes',
5883
5897
  heading: 'Revisions',
5884
5898
  anchor: '#revisions',
5885
- text: 'A quote\'s revision is the version your customer is looking at, starting at Revision 1. When your customer asks for changes, or you want to send different proofs, start the next one:\n1. Open the quote and choose Start revision 2 (or whichever comes next) under Proofs.\n2. Confirm.\nThe revision you had is kept exactly as it stood: its items and totals, notes and terms, its proofs, and every answer your customer gave it. The new revision starts with no proofs and no answer, back at Draft, ready for new proofs and any changes to the quote. Every earlier revision is listed under Earlier revisions in the quote, with its status, its proofs and your customer\'s comments and files, read-only.\nA paid quote takes no new revision. A quote that has earlier revisions can\'t be deleted, because your customer saw them.'
5899
+ text: 'A quote\'s revision is the version your customer is looking at, starting at Revision 1. When your customer rejects a proof with changes, or you want to send different proofs, start the next one:\n1. Open the quote and choose Start revision 2 (or whichever comes next) under Proofs.\n2. Confirm.\nThe revision you had is kept exactly as it stood: its items and totals, notes and terms, its proofs, and every answer your customer gave it. The new revision starts with no proofs and no answer, back at Draft, ready for new proofs and any changes to the quote. Every earlier revision is listed under Earlier revisions in the quote, with its status, its proofs and your customer\'s comments and files, read-only.\nA paid quote takes no new revision. A quote that has earlier revisions can\'t be deleted, because your customer saw them.'
5886
5900
  },
5887
5901
  {
5888
5902
  path: '/commerce-and-bookings/commerce/quotes-and-proofs',
@@ -9067,7 +9081,7 @@ export const DOCS_SECTION_INDEX = [
9067
9081
  title: 'Plugins & Marketplace',
9068
9082
  heading: 'What\'s included',
9069
9083
  anchor: '#whats-included',
9070
- text: 'A listing page carries a What\'s included box. Aglyn generates it from the listing — it is not publisher copy, so it cannot promise something the install does not do, and it says nothing about how much content is in there.\nThe first row is what the install physically produces, which depends on the type:\n| Type | The row reads |\n| Plugin | A plugin, sandboxed on its own origin with a per-plugin CSP |\n| Component | An editable component you can place on any page |\n| Template | Editable pages you can rework in Besigner |\n| Layout | An editable layout you can apply to any page |\n| Dataset schema | A new empty dataset with its fields already defined |\n| Email template | An editable email design you can send campaigns from |\n| Theme | A theme applied to the site you choose |\nThen, in order, up to four more rows:\n- Where it lands. Plugins and dataset schemas install org-wide — Installs org-wide, covering sites you add later. Everything else is site-scoped and says so: Installs per site — new sites are not covered automatically. That row is marked as a note, not a tick, because it is a limit you are being told about rather than something you are getting.\n- Review — This version passed marketplace review — only when the version on offer is approved. A new release from the same publisher starts without it.\n- The license, when the publisher set one: Licensed MIT.\n- Price and updates. A paid listing reads A one-time purchase — updates to this listing are included; a free one reads Free, including every future update. Either way, updates are not a second charge — but they are still deliberate, not automatic.\nWhat the box will never tell you is how many pages or blocks a template contains. Aglyn collects no manifest of that, and counting it would mean inventing a number, so the box st'
9084
+ text: 'A listing page carries a What\'s included box. Aglyn generates it from the listing — it is not publisher copy, so it cannot promise something the install does not do, and it says nothing about how much content is in there.\nThe first row is what the install physically produces, which depends on the type:\n| Type | The row reads |\n| Plugin | A plugin, sandboxed on its own origin with a per-plugin CSP — or, for a version staff signed to run with the site (realm trust), A plugin, reviewed and signed by Aglyn to run with your site |\n| Component | An editable component you can place on any page |\n| Template | Editable pages you can rework in Besigner |\n| Layout | An editable layout you can apply to any page |\n| Dataset schema | A new empty dataset with its fields already defined |\n| Email template | An editable email design you can send campaigns from |\n| Theme | A theme applied to the site you choose |\nA plugin whose version declares a connection to another service adds a plan row straight after it, marked as a note: Connecting Google Business Profile comes with the Starter, Pro and Custom plans. The plugin installs on any plan, but on Free its Connect button is disabled, so the shopper is told before installing rather than after.\nThen, in order, up to four more rows:\n- Where it lands. Plugins and dataset schemas install org-wide — Installs org-wide, covering sites you add later. Everything else is site-scoped and says so: Installs per site — new sites are not covered automatically. That row is marked as a note, not a tick, because it is a limit you are being told about rather than something you are getting.\n- Review — This version passed marketplace review — only when the version on offer is approved. A new release from the same publisher starts without it.\n- The license, whe'
9071
9085
  },
9072
9086
  {
9073
9087
  path: '/developers/plugins/overview',
@@ -10201,7 +10215,7 @@ export const DOCS_SECTION_INDEX = [
10201
10215
  title: 'Environment variables',
10202
10216
  heading: 'Development and Aglyn-internal variables',
10203
10217
  anchor: '#internal',
10204
- text: 'Read by the code, but not operator configuration. Listed so that finding one in the source does not send you looking for a value to put in it.\n| Variable | What it is |\n| AGLYNTENANTDEMO | The tenant host id served when the request host is the console apex or localhost:4500. Default demo. Aglyn\'s own demo deployment. |\n| AGLYNCANARYSITEHOST, AGLYNCANARYMARKETINGHOST | Which hosts the render canary at /api/health/render renders. The site one falls through to AGLYNTENANTDEMO then demo, so an install with no demo host gets a canary reporting red on a host that was never meant to exist. The marketing one derives from your workspace domain and grades not-configured — a deliberate failure, not a pass — when it cannot. |\n| AGLYNTENANTHOSTID, AGLYNTENANTHOSTHOST, AGLYNTENANTHOSTHOSTNAME, AGLYNTENANTHOSTURL | Single-host tenant pinning, for a one-site deployment. Not used by the multi-tenant compose shape. |\n| AGLYNHOST, AGLYNHOSTNAME, AGLYNPORT, AGLYNPROTOCOL, AGLYNURL | Build-time origin overrides in the shared Next config. Leave at the defaults. |\n| AGLYNDISABLEBOOTWARMUP | Skips the tenant\'s boot warm-up. A debugging aid. |\n| CONSENTDEVCOUNTRY | On a non-production build only, the country the consent endpoint answers when no geo header is present — the default is US, so the implied-consent path is testable on a laptop. Hard-gated off when NODEENV=production, so it can do nothing on a real deployment. |\n| NEXTPUBLICAGLYNTENANTLOCALORIGIN, NEXTPUBLICAGLYNTENANTPREVIEWHOST | Where "Live" links point from a local or preview console. Both default to Aglyn\'s own addresses, which matters only on a preview build. |\n| NEXTPUBLICANALYTICSALLOWNONPROD | Development only. |\n| NEXTPUBLICPLUGINDEV, NEXTPUBLICPLUGINDEVBUNDLES, PLUGINDEVMANIFESTS, PLUGINREMOTESERVER, PLUGINREMOTESERVERBUNDL'
10218
+ text: 'Read by the code, but not operator configuration. Listed so that finding one in the source does not send you looking for a value to put in it.\n| Variable | What it is |\n| AGLYNTENANTDEMO | The tenant host id served when the request host is the console apex or localhost:4500. Default demo. Aglyn\'s own demo deployment. |\n| AGLYNCANARYSITEHOST, AGLYNCANARYMARKETINGHOST | Which hosts the render canary at /api/health/render renders. The site one falls through to AGLYNTENANTDEMO then demo, so an install with no demo host gets a canary reporting red on a host that was never meant to exist. The marketing one derives from your workspace domain and grades not-configured — a deliberate failure, not a pass — when it cannot. |\n| AGLYNTENANTHOSTID, AGLYNTENANTHOSTHOST, AGLYNTENANTHOSTHOSTNAME, AGLYNTENANTHOSTURL | Single-host tenant pinning, for a one-site deployment. Not used by the multi-tenant compose shape. |\n| AGLYNHOST, AGLYNHOSTNAME, AGLYNPORT, AGLYNPROTOCOL, AGLYNURL | Build-time origin overrides in the shared Next config. Leave at the defaults. |\n| AGLYNDISABLEBOOTWARMUP | Skips the tenant\'s boot warm-up. A debugging aid. |\n| AGLYNDEBUGMIDDLEWARE | Set to exactly 1 to write the tenant middleware\'s per-request trace (console.debug) to the logs. A debugging aid read at runtime. Unset by default, so the trace stays off and a log drain is not billed for a line per request. |\n| CONSENTDEVCOUNTRY | On a non-production build only, the country the consent endpoint answers when no geo header is present — the default is US, so the implied-consent path is testable on a laptop. Hard-gated off when NODEENV=production, so it can do nothing on a real deployment. |\n| NEXTPUBLICAGLYNTENANTLOCALORIGIN, NEXTPUBLICAGLYNTENANTPREVIEWHOST | Where "Live" links point from a local or preview console'
10205
10219
  },
10206
10220
  {
10207
10221
  path: '/developers/self-hosting-environment',