https://forem-admin.netlify.app/assets/js/9b41e356.7b5e4f60.js

1"use strict";(self.webpackChunkforem_admin=self.webpackChunkforem_admin||[]).push([[2404],{3905:function(e,t,a){a.d(t,{Zo:function(){return c},kt:function(){return d}});var n=a(7294);function r(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function o(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function i(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?o(Object(a),!0).forEach((function(t){r(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):o(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function l(e,t){if(null==e)return{};var a,n,r=function(e,t){if(null==e)return{};var a,n,r={},o=Object.keys(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var s=n.createContext({}),p=function(e){var t=n.useContext(s),a=t;return e&&(a="function"==typeof e?e(t):i(i({},t),e)),a},c=function(e){var t=p(e.components);return n.createElement(s.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},u=n.forwardRef((function(e,t){var a=e.components,r=e.mdxType,o=e.originalType,s=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),u=p(a),d=r,h=u["".concat(s,".").concat(d)]||u[d]||m[d]||o;return a?n.createElement(h,i(i({ref:t},c),{},{components:a})):n.createElement(h,i({ref:t},c))}));function d(e,t){var a=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=a.length,i=new Array(o);i[0]=u;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l.mdxType="string"==typeof e?e:r,i[1]=l;for(var p=2;p<o;p++)i[p]=a[p];return n.createElement.apply(null,i)}return n.createElement.apply(null,a)}u.displayName="MDXCreateElement"},6310:function(e,t,a){a.r(t),a.d(t,{default:function(){return c},frontMatter:function(){return i},metadata:function(){return l},toc:function(){return s}});var n=a(7462),r=a(3366),o=(a(7294),a(3905)),i={description:"A high-level overview of the most important Forem features.",sidebar_position:0},l={unversionedId:"forem-basics/pages",id:"forem-basics/pages",isDocsHomePage:!1,title:"Pages",description:"A high-level overview of the most important Forem features.",source:"@site/docs/forem-basics/pages.md",sourceDirName:"forem-basics",slug:"/forem-basics/pages",permalink:"/docs/forem-basics/pages",editUrl:"https://github.com/forem/admin-docs/edit/main/docs/forem-basics/pages.md",version:"current",sidebarPosition:0,frontMatter:{description:"A high-level overview of the most important Forem features.",sidebar_position:0},sidebar:"tutorialSidebar",previous:{title:"Generated Pages",permalink:"/docs/forem-basics/generated-pages"},next:{title:"Posts",permalink:"/docs/forem-basics/posts"}},s=[{value:"Overview",id:"overview",children:[]},{value:"Creating a Page",id:"creating-a-page",children:[]},{value:"What can you do with pages?",id:"what-can-you-do-with-pages",children:[]}],p={toc:s};function c(e){var t=e.components,a=(0,r.Z)(e,["components"]);return(0,o.kt)("wrapper",(0,n.Z)({},p,a,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("div",{className:"admonition admonition-important alert alert--info"},(0,o.kt)("div",{parentName:"div",className:"admonition-heading"},(0,o.kt)("h5",{parentName:"div"},(0,o.kt)("span",{parentName:"h5",className:"admonition-icon"},(0,o.kt)("svg",{parentName:"span",xmlns:"http://www.w3.org/2000/svg",width:"14",height:"16",viewBox:"0 0 14 16"},(0,o.kt)("path",{parentName:"svg",fillRule:"evenodd",d:"M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"}))),"important")),(0,o.kt)("div",{parentName:"div",className:"admonition-content"},(0,o.kt)("p",{parentName:"div"},"We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit ",(0,o.kt)("a",{parentName:"p",href:"https://forem.dev"},"forem.dev")," to request additional support. We thank you for your patience and hope you're liking the changes!"))),(0,o.kt)("p",null,(0,o.kt)("strong",{parentName:"p"},"Pages")," are a way to store static content on your Forem that won't appear in Feeds. They allow for custom formating ",(0,o.kt)("a",{parentName:"p",href:"/docs/forem-basics/posts"},"compared to Posts")," and can be assigned top level paths."),(0,o.kt)("h2",{id:"overview"},"Overview"),(0,o.kt)("p",null,"The ",(0,o.kt)("inlineCode",{parentName:"p"},"/admin/customization/pages")," page allows you to:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"Create a new page"),(0,o.kt)("li",{parentName:"ul"},"View existing pages")),(0,o.kt)("h2",{id:"creating-a-page"},"Creating a Page"),(0,o.kt)("p",null,"Visiting ",(0,o.kt)("inlineCode",{parentName:"p"},"/admin/customization/pages/new")," allows you to create a new page."),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("strong",{parentName:"li"},"Title")," = The name of the page, appears in the browser window or tab."),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("strong",{parentName:"li"},"Slug")," = The unique page path that this page will be accessed with, e.g. ",(0,o.kt)("inlineCode",{parentName:"li"},"https://yourforem.tld/slug"),". The slug for ",(0,o.kt)("inlineCode",{parentName:"li"},"https://dev.to/code-of-conduct")," is ",(0,o.kt)("inlineCode",{parentName:"li"},"code-of-conduct")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("strong",{parentName:"li"},"Description")," = A description of what the page contains, used mostly by search engines"),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("strong",{parentName:"li"},"Template")," =",(0,o.kt)("ul",{parentName:"li"},(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("a",{parentName:"li",href:"https://dev.to/about"},"Here is an example of a Contained page")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("a",{parentName:"li",href:"https://dev.to/downloads"},"Here is an example of a full_within_layout page")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("a",{parentName:"li",href:"https://dev.to/page/codeland_schedule"},"Here is an example of a json page")))),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("strong",{parentName:"li"},"Body Markdown / Body HTML"),(0,o.kt)("ul",{parentName:"li"},(0,o.kt)("li",{parentName:"ul"},"You'll usually use ",(0,o.kt)("em",{parentName:"li"},"one or the other")),(0,o.kt)("li",{parentName:"ul"},"You should have a very specific reason for using HTML and not Markdown"))),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("strong",{parentName:"li"},"Social Image")," = This is the social image for the page"),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("strong",{parentName:"li"},"Is Top Level Path?"),(0,o.kt)("ul",{parentName:"li"},(0,o.kt)("li",{parentName:"ul"},"If checked, your page lives at ",(0,o.kt)("inlineCode",{parentName:"li"},"/slug")),(0,o.kt)("li",{parentName:"ul"},"If not checked, your page lives at ",(0,o.kt)("inlineCode",{parentName:"li"},"/page/slug")))),(0,o.kt)("li",{parentName:"ul"},"Use as 'Locked Screen'"),(0,o.kt)("li",{parentName:"ul"},"This determines if the page will be used as a landing page for anonymous viewers (landing pages replace the traditional registration screen). This feature only works for private Forems. If your Forem is public, the landing page will not display."),(0,o.kt)("li",{parentName:"ul"},"Only one page can be used as a locked screen at a time."),(0,o.kt)("li",{parentName:"ul"}

1,'Locked screens can be overwritten. To use another locked screen when there is already a locked screen in use, click the "Overwrite current locked screen" button in the modal that appears when "Use as \'Locked Screen\'" is clicked.')),(0,o.kt)("h2",{id:"what-can-you-do-with-pages"},"What can you do with pages?"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("a",{parentName:"li",href:"https://dev.to/about"},"Here is an example of a simple Contained Markdown page")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("a",{parentName:"li",href:"https://dev.to/downloads"},"Here is an example of a full_within_layout page that uses HTML")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("a",{parentName:"li",href:"https://dev.to/page/codeland_schedule"},"Here is an example of a json page ","(","unprettified",")")),(0,o.kt)("li",{parentName:"ul"},"You can create more sophisticated pages, such as:",(0,o.kt)("ul",{parentName:"li"},(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("a",{parentName:"li",href:"https://dev.to/shecoded"},"A blend of static content with custom CSS + dynamic posts")),(0,o.kt)("li",{parentName:"ul"},(0,o.kt)("a",{parentName:"li",href:"https://dev.to/codeland"},"A full-on conference experience"))))))}c.isMDXComponent=!0}}]);