/*@jsxRuntime automatic @jsxImportSource react*/
const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];
const {useMDXComponents: _provideComponents} = arguments[0];
function MDXContent(props = {}) {
  const {wrapper: MDXLayout} = Object.assign({}, _provideComponents(), props.components);
  return MDXLayout ? _jsx(MDXLayout, Object.assign({}, props, {
    children: _jsx(_createMdxContent, {})
  })) : _createMdxContent();
  function _createMdxContent() {
    const _components = Object.assign({
      h1: "h1",
      p: "p",
      a: "a",
      strong: "strong",
      em: "em",
      h2: "h2",
      ul: "ul",
      li: "li",
      code: "code",
      div: "div",
      pre: "pre"
    }, _provideComponents(), props.components);
    return _jsxs(_Fragment, {
      children: [_jsx(_components.h1, {
        id: "create-a-new-site",
        children: "Create a new site"
      }), "\n", _jsxs(_components.p, {
        children: ["You can visit ", _jsx(_components.a, {
          href: "/app/dashboard",
          children: "the dashboard"
        }), ", then click on either the ", _jsx(_components.strong, {
          children: "Create a new site"
        }), " button or the item ", _jsx(_components.strong, {
          children: "New site"
        }), " on the navigation bar to start creating a new site. You will be presented with a form with two fields, ", _jsx(_components.em, {
          children: "site name"
        }), " and ", _jsx(_components.em, {
          children: "site domain"
        }), "."]
      }), "\n", _jsx(_components.h2, {
        id: "site-name",
        children: "Site name"
      }), "\n", _jsx(_components.p, {
        children: "Site names are used to identify your site in the overall dashboard. It is similar to usernames in many websites – you are free to name it however you want, provided the following conditions are met"
      }), "\n", _jsxs(_components.ul, {
        children: ["\n", _jsxs(_components.li, {
          children: ["\n", _jsx(_components.p, {
            children: "The site name should be unique to all of your sites, i.e. you should not have used it as the site name of a different ezkomment site."
          }), "\n"]
        }), "\n", _jsxs(_components.li, {
          children: ["\n", _jsxs(_components.p, {
            children: ["The site name should be a valid URL slug string. If you do not know what a URL slug is, it is hard to go wrong with a name at least 3 characters long, consisting of only Latin characters, digits and the dash character (", _jsx(_components.code, {
              children: "-"
            }), ")."]
          }), "\n"]
        }), "\n"]
      }), "\n", _jsx(_components.p, {
        children: "After the site is created successfully, you can always visit your site dashboard at"
      }), "\n", _jsx(_components.div, {
        className: "remark-highlight",
        children: _jsx(_components.pre, {
          className: "language-unknown",
          children: _jsx(_components.code, {
            className: "language-unknown",
            children: "https://ezkomment.joulev.dev/app/site/⟨siteName⟩"
          })
        })
      }), "\n", _jsx(_components.p, {
        children: "so feel free to bookmark this link."
      }), "\n", _jsx(_components.h2, {
        id: "site-domain",
        children: "Site domain"
      }), "\n", _jsxs(_components.p, {
        children: ["Typically you would not want random people to take your comment section embed URL to embed to their websites. The site domain is for that: only webpages under the domain/subdomain you provide are allowed to embed the comment sections. Then the comment section is \"protected\" by ", _jsx(_components.a, {
          href: "https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/frame-ancestors",
          children: _jsx(_components.code, {
            children: "frame-ancestors"
          })
        }), "."]
      }), "\n", _jsxs(_components.p, {
        children: ["Do note that this protection ", _jsx(_components.a, {
          href: "https://caniuse.com/?search=frame-ancestors",
          children: "may not work for very old browsers"
        }), " (but ezkomment does not support browsers that old anyway)."]
      }), "\n", _jsxs(_components.p, {
        children: ["The protection is also disabled for ", _jsx(_components.code, {
          children: "localhost"
        }), ", so everyone can simply copy the ", _jsx(_components.code, {
          children: "iframe"
        }), " source and see it locally in their machine. This is intentional, since otherwise ", _jsx(_components.em, {
          children: "you"
        }), " would also be locked out of the comment section locally. The embed URL is always public anyway (i.e. people can always open it as a normal webpage), so we consider protecting against ", _jsx(_components.code, {
          children: "localhost"
        }), " is too restrictive."]
      }), "\n", _jsxs(_components.p, {
        children: ["However, if you want to disable all restrictions, simply set the site domain to ", _jsx(_components.code, {
          children: "*"
        }), " (\"catch-all\"), in that case while everyone can embed your comment section to their websites, you can add ezkomment pages for any domains under the ezkomment site."]
      })]
    });
  }
}
return {
  default: MDXContent
};


Authentication

Comments