diff --git a/documentation/changelog-basho/index.html b/documentation/changelog-basho/index.html new file mode 100644 index 0000000..b7954b1 --- /dev/null +++ b/documentation/changelog-basho/index.html @@ -0,0 +1,878 @@ + + + + + + Basho — User Documentation + + + + + + + + + + + +
+ + +
+
+ +
+

Changelog

+
+

Basho releases

+
+
+

2.6.3 May 19, 2025

+
  • Added Support for more social accounts in staff profiles
  • Improved Minor graphic adjustments to the CTA card
  • Other Small bug fixes and performance improvements
+
+
+

2.6.2 Nov 16, 2024

+
  • Added Support for custom fonts
+
+
+

2.6.1 Nov 12, 2024

+
  • Fixed Restored dark appearance of the 'Audio' and 'File' cards in dark mode after changes in Ghost 5.90.0
  • Other Small bug fixes and performance improvements
+
+
+

2.6.0 Jul 18, 2024

+
  • Added Support for the 'webp' format
  • Added The ability to add a second logo for the dark theme version from the 'Design & branding' settings
  • Added The ability to hide the author from the 'Design & branding' settings
  • Added The ability to change the image orientation for the special section from the 'Design & branding' settings
  • Added Support for the Portal option 'Display name in signup form'
  • Added Support for the Portal option 'Prices available at signup'
  • Added Support for the Portal option 'Default price at signup'
  • Added Support for the 'Add a free trial' option for paid tiers
  • Added The logo for the 'Bluesky' service
  • Added The logo for the 'Threads' service
  • Fixed The issue with duplicated text on the 'Account' page
  • Fixed Restored dark appearance of the 'Bookmark' card in dark mode after changes in Ghost 5.87.0
  • Improved The sharing link address for X has been changed from 'twitter.com' to 'x.com'
  • Improved Minor graphical fixes for the comments section after changes in Ghost 5.86.0
  • Updated Changed the copyright from '© [Site name] [Year]' to '© [Year] [Site name]'
  • Other Small bug fixes and performance improvements
+
+
+

2.5.1 Dec 11, 2023

+
  • Fixed Improved the functionality of the 'Special section' when a primary tag is missing in the latest post
+
+
+

2.5.0 Dec 10, 2023

+
  • Added 'Tags for special section' setting has been added in the Ghost Admin
  • Added X icon
  • Updated Replaced the Twitter icon with an X icon, and the text 'Twitter' is now displayed as 'X/Twitter'
  • Updated Documentation has been updated to reflect the new Ghost settings
  • Other Small bug fixes and performance improvements
+
+
+

2.4.0 Aug 18, 2023

+
  • Added Support for Signup card (beta editor)
  • Added Support for new enhanced Header card (beta editor)
  • Added Support for page title/image toggle (beta editor)
  • Removed The 'Account Basic' template
  • Other Small bug fixes and performance improvements
+
+
+

2.3.1 Sep 10, 2022

+
  • Added Support for the data-members-autoredirect atribute to disable auto-redirection after clicking on the magic link
+
+
+

2.3.0 Aug 16, 2022

+
  • Added Support for native comments
  • Updated English translation
  • Other Small bug fixes and performance improvements
+
+
+

2.2.0 Jul 28, 2022

+
  • Added Support for native search option
  • Added Support for {{tier.name}} helper on the account page
  • Other Small bug fixes and performance improvements
+
+
+

2.1.3 Jun 24, 2022

+
  • Improved Tags without posts are now filtered on the tags page
  • Improved Default column names in the footer 'Column [1,2,3]' have been renamed to 'Links'
+
+
+

2.1.2 Jun 21, 2022

+
  • Improved Added clickable links to images in a search result
+
+
+

2.1.1 Jun 4, 2022

+
  • Improved Authors without posts are now filtered on the authors widget on the homepage
  • Other Small bug fixes and performance improvements
+
+
+

2.1.0 Jun 1, 2022

+
  • Added Ability to remove Portal, subscription form and login panel from the theme via Membership settings on the Ghost Admin
  • Added Notification for 'signup-paid' and 'updateEmail' actions
  • Added Ability to change account settings on the account page via Portal (free members)
  • Improved On the account page (paid-members) the 'Change Plan' option was replaced with the 'Account settings' option (via Portal)
  • Improved Authors without posts are now filtered on the authors page
  • Updated English translation
  • Other Small bug fixes and performance improvements
+
+
+

2.0.0 May 23, 2022

+
  • Added Support for Ghost 5.0
  • Removed Deprecated {{monthly_price.value}} and {{yearly_price.value}} helper
  • Removed Deprecated {{name}} value for {{benefits}} helper
  • Removed API versioning from search function
  • Updated English translation
  • Other Small bug fixes and performance improvements
+
+
+

1.2.1 May 13, 2022

+
  • Removed Deprecated {{@price}} helper
  • Updated English translation
+
+
+

1.2.0 Apr 23, 2022

+
  • New Custom authors page
  • New Custom tags page
  • Updated English translation
  • Other Small bug fixes and performance improvements
+
+
+

1.1.0 Apr 12, 2022

+
  • Added Support for 'Tiers'
  • Added Ability to change plan on the account page via Portal
  • Updated English translation
  • Removed Deprecated 'ghost-api' property
  • Other Small bug fixes and performance improvements
+
+
+

1.0.2 Apr 9, 2022

+
  • Other Small bug fixes and performance improvements
+
+
+

1.0.1 Mar 29, 2022

+
  • Other Small bug fixes and performance improvements
+
+
+

1.0.0 Mar 29, 2022

+ +
+
+
+ + + + \ No newline at end of file diff --git a/documentation/index.html b/documentation/index.html new file mode 100644 index 0000000..9fab9bf --- /dev/null +++ b/documentation/index.html @@ -0,0 +1,802 @@ + + + + + + Basho — User Documentation + + + + + + + + + + + +
+ fueko home + fueko home + +
+
+ +
+

Choose a version
of Basho theme

+
+

Available release

+
+
+ + 2.6.3 + Compatible with Ghost:
5.118.0 or later + +
+ +
+ + + + \ No newline at end of file diff --git a/documentation/third-party-materials-basho/index.html b/documentation/third-party-materials-basho/index.html new file mode 100644 index 0000000..e0cb04b --- /dev/null +++ b/documentation/third-party-materials-basho/index.html @@ -0,0 +1,836 @@ + + + + + + Basho — User Documentation + + + + + + + + + + + +
+ + +
+
+ +
+

Third-Party Materials

+

With these resources, this theme can be even better. A huge thank you to all who contributed to this!

+ + +
+

CSS

+
+Normalize.css↗ + + + +
+

JavaScript

+
+clipboard.js↗ +disqusLazy↗ +Flickity↗ +Fuse.js↗ +infinite-scroll↗ +lightense-images↗ +Reframe.js↗ + + + +
+

Fonts

+
+Archivo↗ +Bona Nova↗ +Inter↗ +Lato↗ +EB Garamond↗ +Lora↗ +Nunito↗ +Oswald↗ +Playfair Display↗ +Poppins↗ +Raleway↗ +Roboto↗ +Space Grotesk↗ +Sora↗ +Syne↗ +Work Sans↗ + + +
+ +
+ + + + \ No newline at end of file diff --git a/documentation/version/2-6-3-basho/index.html b/documentation/version/2-6-3-basho/index.html new file mode 100644 index 0000000..d13a03a --- /dev/null +++ b/documentation/version/2-6-3-basho/index.html @@ -0,0 +1,1202 @@ + + + + + + Basho [2.6.3] — User Documentation + + + + + + + + + + + +
+ + +
+
+
+ +
+
+
+ Getting Started +

Introduction

+

The following documentation serves as your guide to the new theme. Since this is Ghost theme documentation, it is assumed that you have a basic knowledge of the Ghost.

+
+
+ Getting Started +

Uploading a theme

+

This is where the magic happens! You are able to upload, activate and delete a theme in the Ghost Admin of your publication.

Step-by-Step
  1. To upload a theme, go to the 'Theme' settings in the Ghost Admin and click 'Change theme' button.
  2. Then click the 'Upload theme' button in the upper right corner.
  3. Once uploaded, click 'Activate' to activate the theme on your site.
+
+
+
+
+ Activation +

Dark, color & partial version

+

The dark, color or partial version introduces a fresh and distinctive appearance for your website, bringing a modern and stylish aesthetic that enhances the visual experience for your visitors.

Step-by-Step
  1. Go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Site-wide' – expand this settings list and go to the 'Color scheme' position.
  3. Use the dropdown menu to select your option.
  4. Finally, click 'Save' to activate.
Tip: How to add a global partial background color?
  1. To add the global partial background color, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Site-wide' – expand this settings list and go to the 'Global background color in hex string' position.
  3. Paste your color – color must be a valid hexadecimal string, e.g. #ffd9e0 – you can generate the color on the site htmlcolorcodes.com.
  4. Finally, click 'Save' to activate.
Tip: Dark, color & partial version depending on operating system preferences
Modern operating systems (Windows, macOS, iOS, etc.) allow users to choose their preference for light or dark system themes. The below feature is used to detect if the user has requested the system to use a light or dark color theme.
  1. To activate an auto dark version based on user operating system preferences, select the 'Auto' option.
  2. Click 'Save' to activate.
+
+
+ Activation +

Search function

+

By default, the theme uses a native search option. You can also use the search function specially designed for this theme — to do this, you must set the Content API key.

Step 1: Generating Content API key
  1. To generate 'Content API key', go to the 'Integrations' settings in the Ghost Admin.
  2. Click 'Add custom integration', then give the new integration a name, like 'Search', and click the 'Add' button.
  3. Copy your 'Content API key' and click 'Save & close'.
Step 2: Activate the search function
  1. Go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Site-wide' – expand this settings list and go to the 'Content API key for search' position.
  3. Paste your 'Content API key'.
  4. Finally, click 'Save' to activate.
+
+
+ Activation +

Slider

+

Select which posts you want to appear at the top of your site in the slider.

Step-by-Step
  1. Open the post you would like to add to the slider.
  2. Then, go to the 'Post settings' panel using the icon in the top right of the screen.
  3. At the bottom of the panel, you'll find a switch labeled 'Feature this post.'
  4. Click the switch and close the panel.

A post must have a feature image to appear in the slider.

+
Tip: How to resize the slider?
  1. To change size the slider, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Homepage' – expand this settings list and go to the 'Slider size' position.
  3. Use the dropdown menu to select your option.
  4. Finally, click 'Save' to activate.
Tip: How to change images orientation?
  1. To change images orintation, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Homepage' – expand this settings list and go to the 'Slider images orintation' position.
  3. Use the dropdown menu to select your option.
  4. Finally, click 'Save' to activate.
  1. Go to the 'Labs' settings in the Ghost Admin, click on 'Beta features' tab and you will find the 'Routes' section.
  2. Upload the routes.yaml file with these settings:
routes:
+
+collections:
+  /:
+    permalink: /{slug}/
+    filter: featured:false
+    template: index
+  /featured/:
+    permalink: /featured/{slug}/
+    filter: featured:true
+    template: index
+
+taxonomies:
+  tag: /tag/{slug}/
+  author: /author/{slug}/

This would set an additional /featured/ URL address for all posts that has been marked as featured. This change is required to remove those posts from the main collection.

+
+
+ Activation +

Social accounts

+
Facebook and X
  1. To add Facebook and X account to your publication, go to the 'Social accounts' settings in the Ghost Admin.
  2. Once adding social accounts, click 'Save' to activate.
  1. Open ../partials/footer_icons.hbs file in your code editor.
  2. Then, uncomment the block – remove the lines which contains {{!-- and --}} for the chosen profile icon.
  3. Now replace the # for each href value with your own profile links.
  4. Save your footer_icons.hbs file in ../partials/ folder.
+
+
+ Activation +

Authors page

+

To present all authors from your publication in an elegant way, you can add a custom authors page.

Step-by-Step
  1. Create a new page, add a page title, and open the 'Page settings' panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled 'Template'.
  3. Use the dropdown menu to select the 'Authors' template, close the panel.
  4. Finally, click 'Publish'.
+
+
+ Activation +

Tags page

+

To present all tags from your publication in an elegant way, you can add a custom tags page.

Step-by-Step
  1. Create a new page, add a page title, and open the 'Page settings' panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled 'Template'.
  3. Use the dropdown menu to select the 'Tags' template, close the panel.
  4. Finally, click 'Publish'.
+
+
+ Activation +

Contact page

+

If you wish to have a direct way in which your readers can contact you, you can add a contact page based on Formspree or Getform.

Step 1: Add your Formspree or Getform endpoint
  1. Go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Site-wide' – expand this settings list and go to the 'Contact form endpoint' position.
  3. Paste your Formspree or Getform endpoint, e.g. https://formspree.io/f/xhyplkej
  4. Finally, click 'Save' to activate.
Step 2: Add a contact page
  1. Create a new page, add a page title, and open the 'Page settings' panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled 'Template'.
  3. Use the dropdown menu to select the 'Contact' template, close the panel.
  4. Finally, click 'Publish'.
+
+
+
+ +
+ Customization +

Navigation

+
Step-by-Step
  1. To add a navigation, go to the 'Navigation' settings in the Ghost Admin.
  2. Once here, you can remove any navigation items that you want by using the trash icon to the right of the item. You can add new items by just typing them in. You can change the order by clicking on the icon on the left and dragging it to the spot you want – the new columns in the 'Secondary' navigation will appear automatically after a few items.
  3. Once your items are added, click 'OK' to activate new navigation on your site.
Tip: How to change the number of items before 'chevron' element in the header navigation? (Requires theme editing)
  1. You’ll need to open the theme’s ../partials/navigation.hbs file in your code editor.
  2. At the top, you’ll see the 'Header navigation' section.
  3. Replace the current to="3" and from="4" value with your own, for example to="4" and from="5".
  4. Save your navigation.hbs file in ../partials/ folder.
  1. To add your own column names, you’ll need to open the theme’s ../locales/en.json file in your code editor.
  2. Then, add your own translations, for example:
{
+    "Column 1": "About",
+    "Column 2": "Features",
+    "Column 3": "Support",
+    ...
+}
+ +
    +
  1. Save your en.json file in ../locales/ folder.
    2. +
+ +
Tip: How to change the number of items in column? (Requires theme editing)
  1. You’ll need to open the theme’s ../partials/navigation.hbs file in your code editor.
  2. At the middle, you’ll see the 'Footer navigation' section.
  3. The columns have a limit and from parameter, that needs to be changed. For example, to change the number of items to 4 for each column:
{{#foreach navigation limit="4"}}
+...
+
+{{#foreach navigation limit="4" from="5"}}
+...
+
+{{#foreach navigation from="9"}}
+...

Another possible case is when you change elements up to e.g. 6 only for second column:

{{#foreach navigation limit="5"}}
+...
+
+{{#foreach navigation limit="6" from="6"}}
+...
+
+{{#foreach navigation from="12"}}
+...
+ +
    +
  1. Save your navigation.hbs file in ../partials/ folder.
    2. +
+ + +
+
+ Customization +

Accent color

+

Primary color used in your publication.

Step-by-Step
  1. To change the accent color in your publication, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Brand' – expand this settings list and go to the 'Accent color' position.
  3. Choose your color.
  4. Finally, click 'Save' to activate.
+
+
+ Customization +

Accent color buttons

+

By default, the buttons (e.g 'Load more') in the theme are in accent color. You can change in to black – with the accent color when hovering the mouse.

Step-by-Step
  1. To deactivate accent color buttons in your publication, go to the 'Design & branding' in the Ghost Admin.
  2. On the right you’ll see the tab 'Site-wide' – expand this settings list and go to the 'Accent color buttons' position.
  3. Use the switch to deactivate the option.
  4. Finally, click 'Save' to activate.
+
+
+ Customization +

Fonts

+

You can change fonts using the 'Typography' setting in the 'Design & branding' section.

Using this option might not always give the best results because fonts are designed for different purposes and can vary in size. The theme doesn’t affect the list of available fonts or adjust them, so it’s a good idea to experiment and find what works best for your needs.
Step-by-Step
  1. Go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right, you’ll see the 'Brand' tab and find the 'Typography' section.
  3. Use the dropdown menu to select your option.
  4. Finally, click 'Save' to activate.
Tip: Special font sets for the theme
Unlike the above option, the theme offers an alternative specifically crafted for it: font sets from the Google Fonts library. These fonts have been thoughtfully chosen to highlight the theme’s unique character, with their sizes and individual attributes precisely tailored to complement it.

You can also select the 'System fonts' option to use local fonts. This choice ensures the best performance for the theme.
Step-by-Step
  1. Go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right, you’ll see the 'Theme' tab, expand this settings list, and find the 'Fonts' position.
  3. Use the dropdown menu to select your option.
  4. Finally, click 'Save' to activate.

Please remember to set the option to 'Theme default' in the 'Typography' section before using the 'Fonts' settings.

+ +
+
+ Customization +

Hero section

+

The hero section includes a title, subscription form or button at the top of the homepage.

Tip: How to add your own hero title?
  1. To add your own hero title, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Homepage' – expand this settings list and go to the 'Hero title text' position.
  3. Enter your own hero title.

If you want your text in bold, use the <span> ... </span>  tag, like this:

Your own <span>hero text</span>

You can also use <b> or <strong> with the same visual result

If you want to start the text on a new line use the <br>  tag, like this:

Your own hero text<br> New text line
+ +
    +
  1. Finally, click 'Save' to activate.
    2. +
+ +
Tip: How to add subscription form or button?
  1. To add subsription form form or button to hero section, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Homepage' – expand this settings list and go to the 'Hero title size and subscription form or button' position.
  3. Use the dropdown menu to select your option.
  4. Finally, click 'Save' to activate.
  1. You can easily replace the /membership/ page with for example /signup/, for this purpose open ../partials/members/subscribe_button.hbs file in your code editor and find:
<a href="{{@site.url}}/membership/" ...
+ +
    +
  1. Then, replace with:
    2. +
+ +
<a href="{{@site.url}}/signup/" ...
+ +
    +
  1. Save your subscribe_button.hbs file in ../partials/members/ folder.
    2. +
  2. Create a 'signup' page with /signup/ page URL.
    3. +
+ + +
+
+ Customization +

Special section

+

You have the option to add a special section with posts on the homepage, below the 'Load more' button.

By default, the section located on the homepage displays related posts to the most recent post if it has a 'primary tag' added.
Tip: How to add a special section with posts for selected tags?
  1. Go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Homepage' – expand this settings list and go to the 'Tags for special section' position.
  3. Enter your tag (or tags) slug, e.g. story,lifestyle,design
+
+
+ Customization +

Hide author

+

Decide whether you want to display the author in the feed and on the post page.

Step-by-Step
  1. To hide the author, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Theme' – expand this settings list and go to the 'Show author' position.
  3. Use the toggle switch.
  4. Finally, click 'Save' to activate.
+
+
+ Customization +

Images orientation

+

You can easily change the orientation of your images.

Tip: How to change images orientation in a 'Slider'?
  1. To change images orintation, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Homepage' – expand this settings list and go to the 'Slider images orintation' position.
  3. Use the dropdown menu to select your option.
  4. Finally, click 'Save' to activate.
Tip: How to change images orientation in a Feed?
  1. To change images orintation, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Site-wide' – expand this settings list and go to the 'Feed images orintation' position.
  3. Use the dropdown menu to select your option.
  4. Finally, click 'Save' to activate.
Tip: How to change images orientation in a 'Special' section?
  1. To change images orintation, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Site-wide' – expand this settings list and go to the 'Special section images orintation' position.
  3. Use the dropdown menu to select your option.
  4. Finally, click 'Save' to activate.
Tip: How to change the orientation of a featured image on a post page?
  1. To change images orintation, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Post' – expand this settings list and go to the 'Feature image orintation' position.
  3. Use the dropdown menu to select your option.
  4. Finally, click 'Save' to activate.
+
+
+ Customization +

Post header layouts

+

The theme includes a collection of post header layouts, allowing you to customize text and images in relation to each other.

Activate 'Classic' template (example)
  1. Open the 'Post settings' panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled 'Template'.
  3. Use the dropdown menu to select the 'Post Classic' template, close the panel.
  4. Finally, click 'Publish'.
Activate 'Center' template (example)
  1. Open the 'Post settings' panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled 'Template'.
  3. Use the dropdown menu to select the 'Post Center' template, close the panel.
  4. Finally, click 'Publish'.
+
+
+ Customization +

Responsive tables

+

The responsive table will display a horizontal scroll bar if the screen is too small to display the full content. The following description applies to the table added using the markdown card.

By default, the table adapts to the window width. If you have a table that is too wide, you can add a container <div class="responsive-table"> element with around the table, and it will display a horizontal scroll bar when needed.
Step-by-Step
  1. To add a responsive table, use the 'Markdown card'.
  2. Add a container <div class="responsive-table"> element with around the table (in markdown there always needs to be a blank line between any HTML and markdown).
<div class="responsive-table">
+
+| # | Heading | Heading | Heading | Heading | Heading |
+|:--|:--------|:--------|:--------|:--------|:--------|
+| 1 | Cell    | Cell    | Cell    | Cell    | Cell    |
+| 2 | Cell    | Cell    | Cell    | Cell    | Cell    |
+| 3 | Cell    | Cell    | Cell    | Cell    | Cell    |
+
+</div>

Markdown table syntax is quite simple. It does not allow row or cell spanning as well as putting multi-line text in a cell. The first row is always the header followed by an extra line with dashes - and optional colons : for forcing column alignment.

Tip: What it takes to generate a table?

To generate a table, you can use the tool Markdown Tables Generator.

+
+
+ Customization +

Footer copyright

+

Customize your own text in the footer by replacing the default value 'Published with Ghost and (...)'.

Step-by-Step
  1. To change footer copyright text, go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Site-wide' – expand this settings list and go to the 'Footer copyright' position.
  3. Enter your own copyright text.
  4. Finally, click 'Save' to activate.
+
+
+
+
+ Members +

Custom pages

+

The members feature allows you to turn any site into a membership business with member signup, paid subscriptions and email newsletters.

The members feature is enabled by default. However, you need to create the following pages to avoid the 404 error.

+
Step-by-Step
  1. Create an Account page.
  2. Create Signup & Signin pages.
  3. Create a Membership page.
Tip: What to do in case of an 400 error with message e.g. 'Missing template members/signin.hbs for route /signin/'
The error indicates that there was previously used a routes.yaml file with another theme that required it. To solve the problem, reset the routes.yaml file to its default settings.
routes:
+
+collections:
+  /:
+    permalink: /{slug}/
+    template: index
+
+taxonomies:
+  tag: /tag/{slug}/
+  author: /author/{slug}/

Default settings for routes.yaml file

+
+
+ Members +

Login panel

+

The login panel is a navigation component that shows 'Join' button when a member is logged out, and 'Account' button when a member is logged in.

Tip: Replacing 'Join' with 'Memberships' (Requires theme editing)
  1. You can easily replace the 'Join' page with 'Membership', for this purpose open ../partials/members/login_panel.hbs file in your code editor and find:
<a href="{{@site.url}}/signup/" class="global-button">{{t "Join"}}</a>
+ +
    +
  1. Then, replace with:
    2. +
+ +
<a href="{{@site.url}}/memberships/" class="global-button">Membership</a>
+ +
    +
  1. Save your login_panel.hbs file in ../partials/members/ folder.
    2. +
+ + +
+
+ Members +

Account page

+

The account page shows your members the type of account they’re having and gives them some subscription specific data.

Step-by-Step
  1. Create a new page, add a page title, and open the 'Page settings' panel using the icon in the top right of the screen.
  2. Provide the appropriate 'Page URL' as /account/
  3. At the bottom of the panel you’ll see a dropdown menu titled 'Template'.
  4. Use the dropdown menu to select the 'Account' template, close the panel.
  5. Finally, click 'Publish'.
+
+
+ Members +

Signup & Signin pages

+

The 'Signup' and 'Signin' pages are allowing your visitors to sign up to your site in order to access members only content.

Step-by-Step
  1. Create a new page, add a page title, and open the 'Page settings' panel using the icon in the top right of the screen.
  2. Provide the appropriate 'Page URL' as /signin/ for the 'Signin' page and /signup/ for the 'Signup' page.
  3. At the bottom of the panel, you’ll see a dropdown menu titled 'Template'.
  4. Use the dropdown menu to select the 'Signin' for the signin page and 'Signup' for the signup page.
  5. Finally, click 'Publish'.
+
+
+ Members +

Membership page

+

The 'Membership' page is helping your visitors to quickly visualize and compare the different pricing plans you offer.

Step-by-Step
  1. Create a new page, add a page title, and open the 'Page settings' panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled 'Template'.
  3. Use the dropdown menu to select the 'Membership' template, close the panel.
  4. Finally, click 'Publish'.
Tip: How to add premium tier?
  1. Go to the 'Tiers' settings in the Ghost Admin.
  2. Click on the 'Connect with Stripe' and configure your Stripe account.
  3. If you have Stripe connected, click '+Add tier' – add your own tier name, description, monthly and yearly prices and list of benefits.
  4. Click 'Save & close'.
  5. Making tiers available to visitors – from the 'Portal settings', you can control which tiers appear on your site.
Tip: How to add description and list of benefits to free tier?
  1. Go to the 'Tiers' settings in the Ghost Admin.
  2. Click 'Free' position and add your tier description and list of benefits.
  3. Finally, click 'Save & close' to activate.
Tip: How to add position to FAQ?

You can add FAQ items in your page content using the 'Toggle card' in the Ghost editor.

The page content on the 'Membership' page only serves to add FAQ items, it is not designed for other types of content.

+ +
+
+ Members +

Subscribe page

+

The subscribe page is allowing your visitors to sign up to your site in order to access members only content and receive the premium newsletter.

Step-by-Step
  1. Create a new page, add a page title, and open the 'Page settings' panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled 'Template'.
  3. Use the dropdown menu to select the 'Subscribe' template, close the panel.
  4. Finally, click 'Publish'.
+
+
+ Members +

Comments

+

The native comments feature in Ghost allows you to invite members to join the discussion and participate in a community directly on your website. Alternatively, you can opt for the Disqus option.

Ghost comments
  1. To enable native comments, go to the 'Access' settings in the Ghost Admin.
  2. Change the 'Commenting' level to 'All members' or 'Paid-members only'.
  3. Finally, click 'Save' to activate.
Disqus comments
  1. Go to the 'Design & branding' settings in the Ghost Admin.
  2. On the right you’ll see the tab 'Post' – expand this settings list and go to the 'Disqus shortname' position.
  3. Paste your 'Disqus shortname', e.g. copy only your-site from your-site.disqus.com
  4. Finally, click 'Save' to activate.
+
+
+
+
+ Advanced +

Editing a theme

+

To edit files, you will need to unzip the theme archive — at this point you will have access to the necessary files indicated in the theme documentation.

Step-by-Step
  1. To edit your theme files, download a copy of the theme. For this purpose go to the 'Design & branding' settings in the Ghost Admin and click 'Change theme' in the bottom right corner.
  2. Use the 'Installed' tab menu in the upper right corner to download your theme, then unzip the theme locally.
  3. Once the theme is unzipped, the files can be edited using an code editor – make the changes indicated in the theme documentation.
You can edit files using applications (code editor) such as Sublime Text, Visual Studio Code or Brackets. Using native text editors like TextEdit on macOS may add formatting may cause the theme to work incorrectly.
+ +
    +
  1. When you’ve finished making changes to the theme code, re-zip the theme directory for uploading back to Ghost.
    2. +
+ +
To create a zip archive on a macOS, right-click on the theme folder to view the context menu. Then, click the 'Compress' option. On Windows right-click on the theme folder, select 'Send to', and then select 'Compressed (zipped) folder'.
+ +
    +
  1. To upload a theme, go to the 'Design & branding' settings in the Ghost Admin and click 'Change theme' in the bottom right corner.
    2. +
  2. Then click the 'Upload theme' button in the upper right corner.
    3. +
  3. Once uploaded, click 'Activate' to activate the theme on your site.
    4. +
+ + +
+
+ Advanced +

Updating a theme

+

Updates to the theme ensure compatibility with the latest Ghost version, performance improvements and minor bug fixes. So it is important that you use the latest available theme version.

If your theme features custom code, updating it with the latest versions will overwrite all your customizations.

+
Step-by-Step
  1. Download the latest version of the theme, then unzip the archive locally.
  2. Choose a theme version that is compatible with your Ghost version.
  3. To upload a theme, go to the 'Design & branding' settings in the Ghost Admin and click 'Change theme' in the bottom right corner.
  4. Then click the 'Upload theme' button in the upper right corner.
  5. Once uploaded, click 'Activate' to activate the theme on your site.
Tip: What if you’ve already edited the theme, and want to update it without losing your changes?

That’s a bit trickier to deal with but not impossible, as long as you can remember what the changes were, or more specifically which files you edited. Unfortunately in Ghost when updating a theme you have to re-enter your changes.

For more advanced users, it can be helpful to use a comparing files app like Sublime Merge – that way you can find your changes if you don’t remember them.

Tip: After uploading the theme my settings in Design section were reset, what should I do?

The best solution is to always use the same name e.g. theme-name.zip – that way you will not have to enter your settings again after uploading a theme.

Ghost assigns the settings in the 'Design & branding' section to the name of the uploaded archive. If you upload theme-v1.zip and theme-v2.zip – Ghost will recognize them as two different themes – so the settings will reset.
+
+
+ Advanced +

Theme translation

+

Translations are used both when you want to add a new language and when you want to edit current phrases used in the theme.

Editing current phrases used in the theme (Requires theme editing)
  1. You’ll need to open the theme’s ../locales/en.json file in your code editor.
  2. Change the sentences used in the theme following the pattern:
{
+    "Old translate": "New translate",
+    ...
+}
+ +
    +
  1. After making your changes, save your file, compress the theme into a zip format, and upload it to Ghost.
    2. +
+ +
Translation to another language (Requires theme editing)
  1. Inside the ../locales/ folder, add target language file for example es.json for Spanish and pl.json for Polish (a valid language code must be used).
  2. Based on the translation from the en.json file, add translations for your language in your code editor. For example, for Spanish, use in the es.json file:
{
+    "Back": "Volver",
+    "Newer Posts": "Artículos Siguientes",
+    "Older Posts": "Artículos Anteriores",
+    ...
+}
+ +
    +
  1. After making your changes, save your file, compress the theme into a zip format, and upload it to Ghost.
    2. +
  2. Then, go to the 'Publication Language' settings in the Ghost Admin.
    3. +
  3. Enter the correct language code into the 'Site language' field.
    4. +
  4. Finally, click 'Save' to activate.
    5. +
+ + +
+
+ Advanced +

Posts per page

+

The number of posts provided will depend on the 'post per page' setting which you can configure in your package.json file.

Step-by-Step (Requires theme editing)
  1. You’ll need to open the theme’s package.json file in your code editor and find:
"config": {
+    ...
+    "posts_per_page": <value>
+    ...
+}
+ +
    +
  1. Change the current value to the expected value.
    2. +
  2. Save your package.json file in root folder.
    3. +
+ + +
+
+
+
+
+ + + + + + \ No newline at end of file