Just Good Themes

WildBird | Ghost Theme Documentation v3.0.0

Theme Documentation

First of all a huge thanks for purchasing this theme! If you have any questions that are not answered here, please feel free to contact us via (email). Thanks so much!

Table of Contents

  1. Theme Information
  2. Theme Installation
  3. Theme Structure
  4. Getting Started
    1. Uploading Favicon
    2. Uploading a Publication Logo
    3. Uploading a Publication Cover
    4. Adding Navigation
    5. Adding Social Media Links
    6. Adding Featured Posts
    7. Members
    8. Enabling Comments
    9. Adding Google Analytics
  5. Theme Customization
    1. Changing Accent Color
    2. Changing Posts Per Page Number
    3. Theme Translation
  6. Credits
  7. Support
  8. Updates

1. Theme Information

2. Theme Installation

  1. Log into the admin section of your Ghost blog: yourblog.com/ghost.
  2. Go to Settings → Design and click on Change theme located at the bottom of the left hand column.
  3. Click on Upload theme.
  4. Drag-and-drop or click and locate the zip file for your theme.
  5. Once it is uploaded, click on either Activate to activate the theme immediately or Close if you want to activate it later on.

3. Theme Structure

Here’s an overview of the main theme files:

4. Getting Started

4.1 Uploading a Favicon

To add a favicon:

  1. Navigate to Settings → Design in your Ghost admin.
  2. Expand the Brand section.
  3. Click Upload icon next to Publication icon.
  4. Save changes.

favicon

To add a logo:

  1. Navigate to Settings → Design in your Ghost admin.
  2. Expand the Brand section.
  3. Click Upload logo next to Publication logo.
  4. Save changes.

logo

4.3 Uploading a Publication Cover

The publication cover image is displayed in the background of the error pages.

To add a publication cover:

  1. Navigate to Settings → Design in your Ghost admin.
  2. Expand the Brand section.
  3. Click Upload image next to Publication cover.
  4. Save changes.

4.4 Adding Navigation

The theme supports primary and secondary navigation. Primary navigation is displayed in the sidebar, while the secondary navigation is displayed in the site footer.

To set up primary and secondary navigation:

  1. Go to Settings → Navigation in your Ghost admin.
  2. Add your navigation items by entering a page name in the label field and a destination URL in the URL field.
  3. Once finished, click Save.

navigation

The social media links are displayed in the sidebar of the theme.

To add Facebook and Twitter links:

  1. Navigate to Settings → General in your Ghost admin.
  2. Click Expand next to Social accounts.
  3. Enter the URLs of your Facebook and Twitter profiles.
  4. Save changes.

All other social media links can be added manually in the widget-social.hbs file located in the partials folder of the theme. For instance, if you want to add the link to your Instagram account use the following code:

<a href="https://www.instagram.com/" target="_blank" rel="noopener" aria-label="Instagram"><span class="screen-reader-text">Instagram</span>{{> "icons/instagram"}}</a>

You can feature up to three of your posts. The featured posts are displayed on the homepage below the hero section.

To mark a post as featured:

  1. Navigate to Posts in your Ghost admin.
  2. Create a new post or open an existing one.
  3. Click on the post settings icon in the top right corner of the Ghost editor.
  4. Check the Feature this post box located at the bottom of the posts settings panel.
  5. Save changes.

featured-post

4.7 Members

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

If members feature is enabled on your site, the theme displays Subscribe and Sign in links in the sidebar and the Subscribe box above the footer. Both, sidebar links and subscribe box button, open the Ghost members portal.

If you wish, you can enable the labels on the posts indicating the post access level (Free or Paid). To do this:

  1. Navigate to Settings → Design in your Ghost admin.
  2. Expand the Site-wide section.
  3. Select the option from the Post access labels dropdown.
  4. Save changes.

4.9 Enabling Comments

Member commenting can be enabled for either All members or Paid-members only from within Ghost Admin, in the Settings → Membership area.

comments

4.10 Adding Google Analytics

To add Google Analytics to your site, please follow the Google Analytics Integration guide by Ghost.

5. Theme Customization

5.1 Changing Accent Color

To change the theme accent color:

  1. Navigate to Settings → Design in your Ghost admin.
  2. Expand the Brand section.
  3. Choose your color.
  4. Save changes.

royce-accent-color

5.2 Changing Posts Per Page Number

You can set the number of post displayed per page in the package.json file of the theme. The default post number is set to 8:

"config": {
	"posts_per_page": 8
}

5.3 Theme Translation

The Royce theme is ready for translations. You can find the default file in the locales folder. Copy locales/en.json to locales/[language_code].json where “language_code” must be replaced with a valid code. You can edit the renamed translation file with any plain text editor.

Even if your site is in English, you can customize any theme texts by simply editing the default English file (locales/en.json), without modifying the theme templates.

You can find more information on how to translate the theme in Ghost documentation.

Please note that currently there is no way to translate or edit the Portal text. The Portal is not the part of the theme files but a core Ghost component.

6. Credits

7. Support

The documentation included provides all the information needed to get the theme installed and customized. However, if you have any questions you can email us at support@justgoodthemes.com, and we will be happy to help you.

If you have any bug reports, or feature requests, please let us know!

8. Updates

As Ghost platform grows, so will this theme. We’re dedicated to keeping our WildBird up to date.

Go To Table of Contents