Pages and URL Slugs

The Pages section is where you localize or rename the URL segments for every Learnomy page, see the full list of frontend pages on your site, and find the folder to copy templates into for a theme override.

What you can do

• Rename each URL segment (course base, lesson, quiz, category, instructor, and more) so links read in your language, for example kurse and lektion for German.
• Change a slug and have Learnomy refresh your WordPress permalink rules automatically on save.
• See a read-only table of every Learnomy frontend page, its URL, whether login is required, and a View link for static pages.
• Leave any slug field blank to keep the built-in default.
• Find the exact theme folder to copy a template into when you want to override the markup.

How to use it

Step 1 -- open Pages

Go to Learnomy Settings and click Pages in the sidebar.

Step 2 -- edit the URL slugs

In the URL Slugs card, change any segment you want to localize or rebrand. Leave a field blank to keep its default. The fields are:

• Course URL Base -- the prefix for course pages (default courses).
• Lesson URL Segment -- the segment inside a lesson URL (default lesson).
• Course Quiz URL Segment -- the segment inside a course quiz URL (default quiz).
• Category URL Segment -- the segment inside a category archive URL (default category).
• Instructor URL Base -- the base for the instructor dashboard and public profiles (default instructor).
• Certificate Verify URL Base -- the base for public certificate verification links (default verify).
• Standalone Quiz URL Base -- the base for quizzes not attached to a course (default quiz).
• Membership URL Base -- the base for the public membership pricing page (default membership).
• My Learning Spaces URL -- the Learning Spaces dashboard URL (default my-spaces; requires the Pro Spaces extension to render).
• Enroll URL Base -- the base for checkout pages (default enroll).
• Account URL Base -- the base for the account and billing pages (default account).

Step 3 -- save

Click Save Changes. Saving any slug change automatically refreshes your permalink rules, so the new URLs work right away.

Step 4 -- check the Frontend Pages table

The Frontend Pages card lists every Learnomy page with its live URL, an access badge (Public or Login required), and a View link for static pages. Pages whose URL contains a placeholder in braces (for example {course-slug}) are marked Dynamic and have no direct View link.

Step 5 -- override a template (optional)

The Theme Override card shows the folder path (your active theme's learnomy/ directory). Copy any file from the plugin's templates/ folder into that path and edit it there to customise the markup for that page.

Settings and options

Every slug saves into the learnomy_settings option under its own key.

The Frontend Pages table and Theme Override path are read-only; they have no save button.

Adding Learnomy pages to a navigation menu

Learnomy's frontend pages are not WordPress pages, so they do not appear in the usual Pages box under Appearance > Menus. They get their own box instead: Learnomy Pages. Tick the pages you want, click Add to Menu, and they behave like any other menu item.

What the box offers:

Two things the box does deliberately:

• It only offers pages that have a fixed address. A course or lesson URL needs a specific course, so those are not listed -- link to an individual course the way you would link to any other URL. Flow steps such as the checkout, thank-you and cancelled pages are absent for the same reason nobody would link to them: they are stages in a purchase, not destinations.
• It hides pages belonging to a switched-off module. With the membership module off, Membership Pricing and Manage Membership do not appear, because those addresses 404 and a menu item pointing at one looks identical to a working one until a visitor clicks it.

Menu items you already built keep working after any of this: the items store a route, not a hardcoded URL, so changing a slug in the table above moves the menu item with it.

When another plugin answers a Learnomy URL

Most LMS plugins want the same addresses Learnomy wants. Tutor LMS, LearnDash and LifterLMS all publish a course archive, and the default address for all of them is some form of /courses/. WordPress does not arbitrate: it serves whichever rule was registered first, so with two LMS plugins active your course catalog can quietly become the other plugin's archive.

The same thing outlives the other plugin. WordPress only rebuilds its URL rules when permalinks are refreshed, so a plugin that is deactivated or deleted without that refresh leaves its rules behind, still owning the address. The symptom is distinctive: /courses/ shows your blog posts, while single course pages such as /courses/my-course/ still work.

Learnomy watches for both.

• A rule left behind by a plugin that is gone is repaired automatically. The next time you open a Learnomy admin page, Learnomy refreshes the URL rules once and your catalog comes back. You do not have to do anything.
• A collision with a plugin that is still active is reported, not resolved. You get a notice on Learnomy admin screens and a Site Health check naming the address and what is answering it. Learnomy will not take the address for itself, because doing so would break the other plugin's pages and only you know which one should win.

To settle a live collision, either change Course URL Base above to something free (academy, training, kurse) or turn off the other plugin. Either way the notice clears on its own.

Site Health carries a permanent check for this: Tools -> Site Health -> Status, under Learnomy course URLs. It is green when every Learnomy address - catalog, courses, lessons, quizzes and the account pages - reaches Learnomy.

For developers

Every slug is also exposed as a filter, so you can set it in code instead of the UI. The filter wins over the saved setting.

• learnomy_base_slug, learnomy_lesson_slug, learnomy_quiz_slug, learnomy_category_slug, learnomy_instructor_slug, learnomy_verify_slug, learnomy_standalone_quiz_slug, learnomy_membership_slug, learnomy_my_spaces_slug, learnomy_enroll_slug, learnomy_account_slug -- one filter per slug (see \Learnomy\reslug_keys() in includes/functions.php for the full map).
• Slugs feed the declarative Route Registry in includes/class-routes.php, which is the single source for both the rewrite rules and URLs. Build every front URL with \Learnomy\route_url( $name, $args ) -- never hardcode home_url('/courses/...').
• learnomy_routes -- filter for registering additional routes (Pro extensions use this so route_url() can build their URLs too).
• learnomy_nav_menu_pages -- filter (array of ['key','label','url']) for the rows offered in the Learnomy Pages navigation-menus box. Pro extensions append their own pages through it, so the box stays a single source of truth rather than each extension adding a box of its own.
• learnomy_route_conflict_force_ownership -- return true to move every Learnomy rewrite rule ahead of every other plugin's in the final rules table. Off by default: it wins the address at the cost of the other plugin's, which is a decision for the site owner rather than for us. \Learnomy\Services\Route_Conflicts::detect() returns the current verdict, and check_now() re-runs it on demand.