♾️Archive (All posts) Template

Principle has a template for the Archive (All posts) Page, which shows all of the posts of your publication. An archive page is not required, but you can add it if you want.

1. Access your Ghost admin area, then navigate to Settings > Labs.

2. Under the Labs section, find and click on the Download current routes button to upload your current routes.yaml file.

3. Open your routes.yaml file in a text editor.

4. Add the following lines to your routes.yaml file:

   routes:
     /:
       controller: channel
       filter: tag:-case-study+tag:-hash-author-content
       template: index
     /account/:
       template: page-account
     /archive/:
       controller: channel
       template: archive
       data: page.archive
       filter: tag:-hash-author-content
     /author/:slug/:
       controller: channel
       template: author
       data: page.slug
       filter: tag:-hash-author-content
     /case-studies/:
       controller: channel
       data: page.custom-case-studies-page
       template: custom-case-studies-page
       filter: tag:case-study
   
   collections:
     /:
       permalink: /{slug}/
       template: index
       filter: tag:-hash-author-content
   taxonomies:
     tag: /tag/{slug}/
     author: /author/{slug}/

5. Save your changes and re-upload the routes.yaml file through the same Labs section by clicking Upload routes file button.

6. After completing these steps, you need to add an Archive Page.

If you have not previously modified your routes.yaml

This guide is intended for users who have not previously modified their routes.yaml file. If you have already made changes to your routes.yaml file, please check this guide.

Here's a quick guide:

• Access your Ghost admin area, then navigate to Settings > Labs.

• Under the Labs section, find and click on the Download current routes button for the routes.yaml file to make a backup.

• Download this routes.yaml :

695B

principle-routes.yaml

In case if you can't download our file, here is how your routes.yaml should look like:

routes:
  /:
    controller: channel
    filter: tag:-case-study+tag:-hash-author-content
    template: index
  /account/:
    template: page-account
  /archive/:
    controller: channel
    template: archive
    data: page.archive
    filter: tag:-hash-author-content
  /author/:slug/:
    controller: channel
    template: author
    data: page.slug
    filter: tag:-hash-author-content
  /case-studies/:
    controller: channel
    data: page.custom-case-studies-page
    template: custom-case-studies-page
    filter: tag:case-study

collections:
  /:
    permalink: /{slug}/
    template: index
    filter: tag:-hash-author-content
taxonomies:
  tag: /tag/{slug}/
  author: /author/{slug}/

• Upload new routes.yaml file through the same Labs section by clicking Upload routes file button.

• After completing these steps, you need to add an Archive Page.

Adding an Archive Page:

1. In your Ghost admin area, go to Pages and click on the New Page button in the top right corner.

2. Title your page. You can choose any title you like for the Archive Page.

3. Click icon in the top right corner to open the Page settings

4. In the Page URL section, ensure the slug is set to archive. This links the page to the route you've set up in your routes.yaml file.

5. Optionally, you can add an excerpt and feature an image to make the page more engaging.

6. Once you're done, click on Publish to make your Archive Page live.

This page will now follow the Archive template and functionality as defined in your routes.yaml file.