First-run setup: pages and shortcodes

Home » Getting Started » First-run setup: pages and shortcodes

NiroHelp needs a few WordPress pages to drive its public side. To save you the work, the plugin creates them for you on activation and selects them in settings automatically. You only need to step in if you want different titles, slugs or layouts.

What gets created on activation

On first activation NiroHelp creates these pages and selects them in NiroHelp → Settings:

PageShortcodeWhere it is selected
Docs[nirohelp_docs]Documentation → Pages → Docs archive page
My Tickets[nirohelp_tickets]Tickets → Pages → My Tickets page
Submit a Ticket[nirohelp_new_ticket]Tickets → Pages → New Ticket page

All three are published pages with comments and pingbacks closed. They are created whichever modules you have on, so a docs-only site still gets the two ticket pages – delete them if you do not want them.

The installer never duplicates work:

  • If a setting already points at a live page, it is left alone.
  • If a page already exists containing the matching shortcode, that page is adopted instead of a second one being created.

So deactivating and reactivating, or installing on a site you had already set up by hand, will not leave you with duplicate pages.

The other three shortcodes

Three more shortcodes exist that the installer does not create a page for:

ShortcodeWhat it renders
[nirohelp_login_form]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.
[nirohelp_all_tickets]The full ticket queue, for agents who work from the front end. Select the page under Tickets → Pages → All Tickets page if you use it.
[nirohelp_code]A syntax-highlighted code block, used inside a doc rather than on a page of its own. See Code blocks and images.

Renaming or replacing the auto-created pages

These are ordinary WordPress pages. You can:

  • Rename them — Documentation instead of Docs, say — under Pages.
  • Change their slug, parent or template like any other page.
  • Replace them entirely: make your own page containing the relevant shortcode, then pick it again in NiroHelp → Settings under Documentation or Tickets.

These settings do two jobs beyond pointing at a page. Notification emails build their links from them, and the docs page’s slug becomes the first part of every doc address. Renaming that page’s slug from docs to help moves your whole knowledge base – see Doc URLs.

Add the pages to your menu

Most themes have an Appearance → Menus screen. Add the new pages to your main menu so visitors can find them.

What if a page is not selected?

The plugin still works, but ticket emails fall back to your home page when they need to send a client to their ticket, and doc addresses fall back to the default. Make sure the docs page and both ticket pages are selected once you start using the matching module.

If you move a selected page to the trash, the next activation notices and creates or adopts a replacement.

Was this doc helpful?

Scroll to Top