> For the complete documentation index, see [llms.txt](https://docs.themeupstudio.com/travio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.themeupstudio.com/travio/rename-taxonomies/audit-checklist.md). # Audit Checklist ## Final Checklist Use this page after you finish the rename. ### Normal rename checklist For the recommended end-user rename, confirm these items: * `locales/en.json` visible labels updated * `routes.yaml` route paths updated if public URLs changed * Ghost Pages created or renamed to match `data: page.` * Homepage section links updated * Homepage hero page lookups updated * Ghost Navigation labels and normal URLs updated * Special nav tokens kept as `[destinations]` and `[experiences]` * Theme re-uploaded * `routes.yaml` uploaded in Ghost Admin ### Pages to test Visit these pages after uploading the changed theme and routes: * Homepage * Your renamed destinations page, for example `/places/` * Your renamed experiences page, for example `/travel-styles/` * A normal tag page * A tag page that belongs to the first group * A tag page that belongs to the second group * Articles page * Archive page * Videos page * An author page * A single post page Check that: * Headings use the new names * Header dropdowns use the new names * Header dropdown options open the correct tag pages * Homepage "View all" links go to the new URLs * Homepage hero CTA cards go to the new URLs * Load-more buttons work on both renamed index pages * Filters still work * No obvious warning appears in the header ### Common issues #### The renamed page returns 404 Check: * The route exists in the uploaded `routes.yaml` * The route has a trailing slash, for example `/places/` * The Ghost Page slug matches the `data: page.` value * The routes file was uploaded after editing #### The homepage "View all" link still goes to the old URL Update: * `partials/homepage/section-home-destinations.hbs` * `partials/homepage/section-home-experiences.hbs` Then upload the changed theme again. #### The homepage hero CTA still goes to the old page Update: * `partials/homepage/hero.hbs` Make sure the slugs in this file match your new Ghost Page slugs. #### Header special dropdowns do not appear Check: * The Primary Navigation uses `[destinations]` and/or `[experiences]` * The corresponding theme setting has a comma-separated tag slug list * The listed tags exist in Ghost * The listed tags are public tags, not internal tags #### Load more stopped working This usually means an internal selector was changed by mistake. Check: * `destinations.hbs` * `experiences.hbs` * `assets/js/scripts.js` If you edited JavaScript, run `npm run build` before uploading the theme again. ### Developer audit reference The sections below list the code areas that use destination and experience naming. Most users do not need to edit every file in this list. #### Routes and page data | File | What to check | | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `routes.yaml` | `/destinations/`, `/experiences/`, `template: destinations`, `template: experiences`, `data: page.destinations`, `data: page.experiences` | | `partials/homepage/section-home-destinations.hbs` | `link_url="/destinations/"` | | `partials/homepage/section-home-experiences.hbs` | `link_url="/experiences/"` | | `partials/homepage/hero.hbs` | `slug:destinations`, `slug:experiences` page lookups | #### Locale labels | File | What to check | | ----------------- | -------------------------------------------------------------------------------------------------------- | | `locales/en.json` | Destination/Experience labels, placeholders, load-more text, ribbon aria labels, navigation warning copy | #### Theme settings | File | What to check | | -------------- | -------------------------------------------------------------------------------------------------- | | `package.json` | `custom.destinations`, `custom.experiences`, setting descriptions, `show_home_ribbons` description | #### Header and navigation | File | What to check | | ------------------------- | -------------------------------------------------------------------------- | | `partials/navigation.hbs` | Special tokens `[destinations]`, `[experiences]`, dataset flags | | `partials/header.hbs` | Header dropdowns, labels, icon paths, special token controls, warning copy | | `assets/js/scripts.js` | `handleDestinationDropdown`, dropdown selection logic | #### Homepage | File | What to check | | ------------------------------------------------- | ------------------------------------------------------------------- | | `home.hbs` | Includes `section-home-destinations` and `section-home-experiences` | | `partials/homepage/section-home-destinations.hbs` | Destination tag query, section title, card partial, route link | | `partials/homepage/section-home-experiences.hbs` | Experience tag query, section title, card partial, route link | | `partials/homepage/section-home-ribbons.hbs` | Combined and individual ribbon labels and tag queries | | `partials/homepage/hero.hbs` | Page CTA lookups and experience floating badge queries | #### Taxonomy index pages | File | What to check | | ------------------------------------- | --------------------------------------------------------- | | `destinations.hbs` | Destination index query, load-more selectors, button text | | `experiences.hbs` | Experience index query, load-more selectors, button text | | `partials/cards/card-destination.hbs` | Destination card selector and visual treatment | | `partials/cards/card-experience.hbs` | Experience card selector and visual treatment | | `assets/js/scripts.js` | Destination and experience load-more handlers | #### Filters | File | What to check | | --------------------------------- | ------------------------------------------------------------------- | | `index.hbs` | Article page destination/experience filters | | `archive.hbs` | Archive page destination/experience/date filters | | `videos.hbs` | Video page destination/experience filters | | `author.hbs` | Author page destination/experience filters | | `tag.hbs` | Dispatches destination/experience tags to the custom tag layout | | `partials/tag/layout-default.hbs` | Default tag page filters | | `partials/tag/layout-custom.hbs` | Destination/experience tag page filters | | `partials/scripts.hbs` | Inline filter visibility defaults and aliases | | `assets/js/scripts.js` | Filter visibility defaults, aliases, page config, filter controller | #### Post cards and post heroes Destination tags are displayed as prominent chips and removed from generic tag lists. Check these files if you rename the first taxonomy group or change that behavior: * `partials/cards/card-post.hbs` * `partials/cards/card-post-wide.hbs` * `partials/cards/card-post-small.hbs` * `post.hbs` * `custom-post-hero-background-image.hbs` * `custom-post-hero-default.hbs` * `custom-post-hero-gallery.hbs` * `custom-post-hero-scrolling-mosaic.hbs` * `custom-post-hero-slider.hbs` * `custom-post-hero-video.hbs` * `custom-post-hero-wide-image.hbs` * `partials/post/post-hero-background-image.hbs` * `partials/post/post-hero-default.hbs` * `partials/post/post-hero-gallery.hbs` * `partials/post/post-hero-scrolling-mosaic.hbs` * `partials/post/post-hero-slider.hbs` * `partials/post/post-hero-video.hbs` * `partials/post/post-hero-wide-image.hbs` #### Documentation and package notes Update public docs or README text where it mentions: * `/destinations/` * `/experiences/` * `destinations` * `experiences` * `[destinations]` * `[experiences]` * Destination/experience filters In this repo, the internal README also contains those references. ### Rebuild checklist Run a build only if you edited JavaScript or CSS source files: ```bash npm run build ``` Run theme validation before packaging: ```bash npm test ``` `npm test` runs the build first through `pretest`, then runs Ghost's theme scanner.