{"id":10,"date":"2026-09-09T04:25:14","date_gmt":"2026-09-09T04:25:14","guid":{"rendered":"https:\/\/nirohelp.com\/docs\/10\/first-run-setup\/"},"modified":"2026-09-09T04:26:01","modified_gmt":"2026-09-09T04:26:01","slug":"first-run-setup","status":"publish","type":"nirohelp_doc","link":"https:\/\/nirohelp.com\/docs\/getting-started\/first-run-setup\/","title":{"rendered":"First-run setup: pages and shortcodes"},"content":{"rendered":"<p>NiroHelp needs a few WordPress pages to drive its public side. To save you the<br \/>\nwork, the plugin creates them for you on activation and selects them in<br \/>\nsettings automatically. You only need to step in if you want different titles,<br \/>\nslugs or layouts.<\/p>\n<h2>What gets created on activation<\/h2>\n<p>On first activation NiroHelp creates these pages and selects them in<br \/>\n<strong>NiroHelp \u2192 Settings<\/strong>:<\/p>\n<table>\n<thead>\n<tr>\n<th>Page<\/th>\n<th>Shortcode<\/th>\n<th>Where it is selected<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Docs<\/td>\n<td><code>[nirohelp_docs]<\/code><\/td>\n<td>Documentation \u2192 Pages \u2192 Docs archive page<\/td>\n<\/tr>\n<tr>\n<td>My Tickets<\/td>\n<td><code>[nirohelp_tickets]<\/code><\/td>\n<td>Tickets \u2192 Pages \u2192 My Tickets page<\/td>\n<\/tr>\n<tr>\n<td>Submit a Ticket<\/td>\n<td><code>[nirohelp_new_ticket]<\/code><\/td>\n<td>Tickets \u2192 Pages \u2192 New Ticket page<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>All three are published pages with comments and pingbacks closed. They are<br \/>\ncreated whichever modules you have on, so a docs-only site still gets the two<br \/>\nticket pages \u2014 delete them if you do not want them.<\/p>\n<p>The installer never duplicates work:<\/p>\n<ul>\n<li>If a setting already points at a live page, it is left alone.<\/li>\n<li>If a page already exists containing the matching shortcode, that page is<br \/>\n  adopted instead of a second one being created.<\/li>\n<\/ul>\n<p>So deactivating and reactivating, or installing on a site you had already set<br \/>\nup by hand, will not leave you with duplicate pages.<\/p>\n<h2>The other three shortcodes<\/h2>\n<p>Three more shortcodes exist that the installer does <strong>not<\/strong> create a page for:<\/p>\n<table>\n<thead>\n<tr>\n<th>Shortcode<\/th>\n<th>What it renders<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>[nirohelp_login_form]<\/code><\/td>\n<td>The login form on its own. It is already shown inside the My Tickets and Submit a Ticket pages for logged-out visitors, so a page of its own is optional.<\/td>\n<\/tr>\n<tr>\n<td><code>[nirohelp_all_tickets]<\/code><\/td>\n<td>The full ticket queue, for agents who work from the front end. Select the page under <strong>Tickets \u2192 Pages \u2192 All Tickets page<\/strong> if you use it.<\/td>\n<\/tr>\n<tr>\n<td><code>[nirohelp_code]<\/code><\/td>\n<td>A syntax-highlighted code block, used inside a doc rather than on a page of its own. See <a href=\"https:\/\/nirohelp.com\/docs\/knowledge-base\/code-blocks-and-images\/\">Code blocks and images<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Renaming or replacing the auto-created pages<\/h2>\n<p>These are ordinary WordPress pages. You can:<\/p>\n<ul>\n<li>Rename them \u2014 <em>Documentation<\/em> instead of <em>Docs<\/em>, say \u2014 under <strong>Pages<\/strong>.<\/li>\n<li>Change their slug, parent or template like any other page.<\/li>\n<li>Replace them entirely: make your own page containing the relevant shortcode,<br \/>\n  then pick it again in <strong>NiroHelp \u2192 Settings<\/strong> under <strong>Documentation<\/strong> or<br \/>\n  <strong>Tickets<\/strong>.<\/li>\n<\/ul>\n<p>These settings do two jobs beyond pointing at a page. Notification emails build<br \/>\ntheir links from them, and <strong>the docs page&#8217;s slug becomes the first part of<br \/>\nevery doc address<\/strong>. Renaming that page&#8217;s slug from <code>docs<\/code> to <code>help<\/code> moves your<br \/>\nwhole knowledge base \u2014 see <a href=\"https:\/\/nirohelp.com\/docs\/knowledge-base\/doc-urls\/\">Doc URLs<\/a>.<\/p>\n<h2>Add the pages to your menu<\/h2>\n<p>Most themes have an <strong>Appearance \u2192 Menus<\/strong> screen. Add the new pages to your<br \/>\nmain menu so visitors can find them.<\/p>\n<h2>What if a page is not selected?<\/h2>\n<p>The plugin still works, but ticket emails fall back to your home page when they<br \/>\nneed to send a client to their ticket, and doc addresses fall back to the<br \/>\ndefault. Make sure the docs page and both ticket pages are selected once you<br \/>\nstart using the matching module.<\/p>\n<p>If you move a selected page to the trash, the next activation notices and<br \/>\ncreates or adopts a replacement.<\/p>\n","protected":false},"author":1,"featured_media":0,"template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"nirohelp_product":[],"nirohelp_topic":[2],"class_list":["post-10","nirohelp_doc","type-nirohelp_doc","status-publish","hentry","nirohelp_topic-getting-started"],"_links":{"self":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc\/10","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc"}],"about":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/types\/nirohelp_doc"}],"author":[{"embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/media?parent=10"}],"wp:term":[{"taxonomy":"nirohelp_product","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_product?post=10"},{"taxonomy":"nirohelp_topic","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_topic?post=10"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}