Blooria Documentation

Getting Started

Blooria is a minimalist ghost theme crafted for influencers, bloggers, authors, marketers, and entrepreneurs. With a focus on crisp typography and unique styling will highlight your content beautifully and communicate an authentic and high-quality brand to your readers.

Support

If you have any questions that are beyond the scope of this help file, please feel free to send your questions to our support email: [email protected]. Our support team will reply you within 6 hours.

Template Information

• Name: Writter
• Author: Electronthemes
• Platform: Ghost
• Demo: Blooria
• Created: 06 May 2020
• Last Update: 07 Jun 2021 See Changelog
• Version: 4.0.0

Features

General Features

• Clean Design
• Dark version and Light version
• Responsive Theme
• W3 validated Code
• Ghost 4.x compatible
• Content API v4
• Publication title and description
• Primary Navigation
• Secondary Navigation
• Social accounts link
• Publication icon, logo and cover image
• Tags with name description and image
• Featured post slider
• Primary tag
• Primary author
• Multi author
• Popular tags
• Cool footer design
• Tag list
• Tag feature image
• Tag post count
• Tag description
• Tag posts
• Author lists
• Author cover image
• Author Social links
• Author Posts
• Load more posts button
• Koenig Editor
• Gallery and Bookmark and all other inbuilt card in Koenig editor
• Responsive YouTube, Vimeo and all other embed
• Normal image
• Wide and full width image support
• Medium zoom image
• Gallery support
• Social post share
• Related posts
• Post navigation
• Disqus comment box
• Built on Bootstrap 4.x
• Font awesome icons
• Subscription form
• 24/7Support
• SEO friendly code
• Image lazy load

Ghost inbuilt features

• Ghost supported v4.0.0
• Publication and Description
• Publication cover
• Publication logo and icon
• Social accounts
• Koenig Editor
• Primary Navigation
• Secondary Navigation
• General posts and pages
• Tags
• Authors
• Responsive Content
• Gallery
• Bookmark
• HTML code
• Code Highlighter
• Share posts on social media
• Post Navigation
• Load more options
• Translation ready to other language
• Subscription features
• Membership
• Signin
• Signup
• Notifications

Pages

• Homepage
• Post page
• Tag page
• Author page
• Error
• Page
• Error-404

Custom Pages

• Custom Author list
• Custom Tag list
• Custom Contact
• Custom Account
• Custom Membership
• Custom Signin
• Custom Signup

Theme Setup

Blooria theme setup is very easy. If you have already installed a server for Ghost you can easily setup Blooria theme. If you don’t have server suported with Ghost, you can set up reading Ghost Install. When you have the server, follow the instructions for setting up the theme.

Upload the theme

You can upload the theme file from ghost dashboard. to do this

• Log in into your Ghost admin panel.
• Go to settings (design section) and upload “blooria.zip“
• Click Activate.

Uploading the theme via (FTP)

Follow the instructions

• Login to your FTP account.
• Unzip the blooria.zip file and copy blooria folder to your /ghost_installation/content/themes
• Restart your installation if necessary. You can ask for help from your hosting provider if you don’t know how to do this step.
• Login to your ghost admin panel.
• Go to settings (general) and select theme “Blooria“
• Click Save.

General Setup

Publication Info

To change publication info, go to Dashboard > General > Publication Info. Here you can change the followings:

• Title
• Description
• Site Timezone
• Publication Language

Logo

We have used SVG Logo for the theme . You can change SVG Logo from Dashboard > General > Publication Identity

Favicon Icon

Ghost shows his ghost logo in your site by default. You can change Favicon Icon or Publication Icon from Dashboard > General > Publication Identity

Publication Cover

This is for showing site bookmark image. If you upload a cover image, it will in your site bookmark

Site Meta Settings

This is for Meta data. It will help to get on search using search engine. You can add also Twitter and Facebook card image, content here.

You can add/edit the content from Dashboard > General > Site Meta Settings

Social Accounts

Social account section is for showing Facebook, Twitter links of your site. Go to Dashboard > Settings > Social Accounts

Primary Navigation

Ghost only support two types of Navigation. Primary and Secondary Navigation Menu. On header, primary navigation is showing and On Footer secondary navigation is showing. Go to Dashboard > Design > Navigation

Secondary Navigation

Secondary Navigation is showing at footer. To add Secondary menu item, go to Dashboard > Design > Secondary Navigation

Create a Post

Ghost has a beautiful dashboard design. You can easily create a post. Go to Dashboard > Posts > New Post

• Post Title
• Post Contents
• Feature image
• Tags
• Authors

Create a page

As like as post, you can create a new page from Dashboard > Pages > New Page. You can add:

• Title
• Contents
• Tags
• Authors
• Feature Image
• Excerpt
• more…

Featured Post

Ghost has awesome featured posts option to show some of your chosen posts as featured for the visitors. To add a post as featured, go to Post > Settings and scroll down. Select the checkbox Feature this post

Create Tag

To create a new tag, go to Dashboard > Tags > New Tag

Create Author

You can create multiple author in your site from dashboard. Go to Dashboard > Stuff > Invite people

Click on Invite people and you will get a new popup. You have to add Email Address and select the staff Role. Lastly click on Send Invitation now button. An email notification will be sent to create an account on the specific Role.

Code Injection

Code injection is a great feature on Ghost. You can easily write styles and scripts for your site without editing the theme file. You can add various plugins code here like Google analytics

Here you will two text field for code injections. 1. Site Header and 2. Site Footer

Site Header

If you write scripts on site header, it will show in <head> tag of header. It will load first in your site

Site Footer

If you write scripts on site footer, it will show at the closing of <body> tag. It will load last in your site

Integrations and Custom Integrations

Integrations are another cool feature of Ghost. You can connect a lot of thirdparty plugins or API using integrations. To check the integrations, go to Dashboard > Integrations. You will get some inbuilt integrations and custom integrations options

Custom integrations

To create custom integrations, click on + Add custom integration at the bottom of the page and you will get a popup and add a name of the integration and Create. I have create here Search and Github Deploy integration

Labs

Labs is another very important and beta tester parts of Ghost. Here your will get some core features as follows: Go to Dashboard > Labs

1. Membership
2. Import Content
3. Export your content
4. Delete All Content
5. Night shift
6. Redirects
7. Routes

Members

If you want to get subscriptions and paid customers, you can use Members option in this panel. When you click on this you will get in details

Migration Options

You will get some options here like Import content, export content and delete content options

Routes

Routes is another important part. When you want to use different path link or custom files for pages and different homepage, you can use routes.yaml file to do that. Here is default .yaml for ghost.

routes:

collections:
  /:
    permalink: /{slug}/
    template: index

taxonomies:
  tag: /tag/{slug}/
  author: /author/{slug}/

Header

For header, we have used {{> header}} partials in folder partials/ header.hbs. In this file you can change the followings:

1. Logo
2. Primary Navigation
3. Search
4. Dark Light Icon
5. Signin & Subscribe

To change the logo markup or text, find this structure on logo.hbs file

{{#if @site.logo}}
    <a href="{{@site.url}}">
        <img src="{{@site.logo}}" alt="{{@site.title}}">
    </a>
{{else}}
    <h2><a href="{{@site.url}}">{{@site.title}}</a></h2>
{{/if}}

Primary Navigation

For Primary navigation, go to Dashboard > Design > Primary Navigation

Signin and Subscribe

Signin and Subscribe button is coming from partials/members/members-navigation.hbs partials. If you want to change, edit the file members-navigation.hbs

If you want to remove membership menu, just remove this line {{> members/members-navigation}} from partials/header.hbs file

Footer

We used very minimal footer in our theme. You will get all footer code partials > footer.hbs file. Here are the following parts:

1. Logo
2. Secondary Menu
3. Social Profiles
4. Copyright text

Footer Logo

At footer, we have used same logo as like as header. If you want to change footer logo, go to logo.hbs file. If you want to remove footer logo, edit footer.hbs file from partials folder.

Remove this

<div class="col-xl-2 col-lg-3">
    <div class="f-logo">
        {{> logo}}
    </div>
</div>

Secondary Menu

You can add footer menu from Dashboard > Design > Secondary Menu

Social Profiles

Social profiles code are on social-profiles.hbs file of partials folder. Faceboook and Twitter are from Dashboard > General > Social Accounts. Other social profiles/links can be changed at social-profiles.hbs file

If you want to add more icons you can do.

1. Add svg icon in the social-icons folder partials > icons > social-icons
2. Repeat this line <li><a href="#">{{> icons/social-icons/linkedin}}</a></li>
3. Change the icon name and link

Copyright text

You can change at footer.hbs file line number 34

<p>{{t "© Copyright 2020 blooria. Published with "}}<a target="_blank" href="https://ghost.org/">Ghost</a></p>

Homepage

In homepage, you will get some sections.

1. Featured Slider
2. Latest Posts
3. Special Tags
4. Popular Tags
5. Subscribe

Featured Posts Slider

We have showed a slider on homepage will the featured posts. If you set a post as featured, it will be added automatically in the slider. See this section how to add featured post

Featured slider post limit is 5. If you want to increase or decrease post limit, go to partials/featured-slider.hbs and edit limit="5".

{{#get "posts" limit="5" filter="featured:true" include="authors,tags"}}

If you want to remove featured posts slider from homepage, remove the following line from index.hbs

{{!-- Featured posts slider --}}
{{#is "home"}}
{{> featured-posts}}
{{/is}}

Latest posts

You will get all latest posts at loop.hbs file of partials folder

Special Tags

We have used 2 special tags in special tags section. Edit the file special-tags.hbs. You will get 2 special tags partials {{> tag-special-1}} and {{> tag-special-2}}

I have used two special tags sports and food. To change the tag name go to tag-special-1.hbs in the partials folder and edit the filter filter="tag:sports" sports. You can change the name also at line number 4.

<h4 class="special-tags-title mb-50">{{t "#sports"}}</h4>

Popular Tags

Popular tags comes from popular-tags.hbs file at partials folder. We have used 6 popular tags based on the number of posts. You can change the limit from the file. Change limit="6" from line number 1 of popular-tags.hbs file.

To change view all text and link go to line number 11 and change it. I have used /tags for all list of tags page. You can change it with yours tags page name.

Subscribe

For subscribe section, you will get subscribe.hbs in the partials folder. Background image comes from site cover image. You can see how to change site cover image

Custom Templates

Custom template is a default setting on Ghost. It can be page template and post template. We have created some custom page and post template for the theme. The page template are as follows:

Page Template

• Membership
• Account
• Contact
• Authors
• Tags

Selecting page template

1. Create a new page
2. Click on Settings to the right side and scroll down
3. Select page template i.e. “Membership”

Page url

When you create page, please keep page slug like this.

Page title	Page URl
Membership	/membership/
Account	/account/

For other custom pages, you can add Authors, Tags, Contact page.

Membership and Subscriptions

This is an awesome features of Ghost. If you want to make money with publications, you can use Membership features of Ghost. To enable members, go to Dashboard > Labs > Members

Portal Settings

In portal seetings, you can enable Subscribe button at the bottom right of the site.

• Show signup and signin form in popup
• Showing pricing plans
• Changing ancient colors
• Changing icons and text

Stripe connection

Connect your stripe account to get the payment from your subscribers

Subscription Pricing

Add or change your subscription pricing from here

Post Access

When you enable members, you can manage your posts who will see your default posts.

Email Newsletter

You can customize your newsletter template from here

You can also change your support email and email newsletter setting with mailgun using this

Pricing Tables

Here we have used 3 pricing plans.

1. Free/Basic Plan
2. Monthly Plan
3. Yearly Plan

Change the text inside <li>{{t "..."}}</li>

Free/Basic Plan: For changing basic plan {{> members/pricing-tables/plan-free}} partials is used. You will find partials > members > pricing-tables > plan-free.hbs

<ul>
    <li>{{t "full access to post for subscribe"}}</li>
    <li>{{t "weekly email newsletter"}}</li>
    <li>{{t "no advertising"}}</li>
</ul>

Monthly Plan: For monthly plan {{> members/pricing-tables/monthly-monthly}} partials is used. You will find partials > members > pricing-tables > plan-monthly.hbs

<ul>
    <li>{{t "full access to post for subscribe"}}</li>
    <li>{{t "weekly email newsletter"}}</li>
    <li>{{t "Daily updates"}}</li>
    <li>{{t "Support independent publishing"}}</li>
    <li>{{t "Secure Payments"}}</li>
    <li>{{t "No advertisement"}}</li>
</ul>

Yearly Plan: For yearly plan {{> members/pricing-tables/plan-yearly}} partials is used. You will find partials > members > pricing-tables > plan-yearly.hbs

<ul>
    <li>{{t "full access to post for subscribe"}}</li>
    <li>{{t "weekly email newsletter"}}</li>
    <li>{{t "Support independent publishing"}}</li>
    <li>{{t "Secure Payments"}}</li>
    <li>{{t "No advertisement"}}</li>
    <li>{{t "One step way to pay"}}</li>
</ul>

Account Informations

Free Subscriber information

You can change the account information text on header page also. To change the information, go to partials > members > free-subscriber-information.hbs

Paid subscriber information

You can change the account information text on header page also. To change the information, go to partials > members > subscriber-information.hbs

Third Party Plugins

We have created real time search options and Formspree for contact form.

Search Options

We have used Fuse.io for creating real time search. When you will type, you will get instant results. When you install the theme file, you have configure and add content api key on condeinjection

1. Create a custom integrations
2. Copy Content Api Key from your created custom integration
3. Go to Code Injection > Site Header as follows

<script>
    var contentApiKey = "your content api key"
</script>

Contact form

In contact form, we have used Formspree for getting form data. Change your email in <form> tag in custom-contact.hbs file at line number 13.

<form class="row" action="https://formspree.io/[email protected]"  method="POST">

To change contact information, go to custom-contact.hbs file. You change all of the information.

Github Deployment

Blooria theme in ready for deploy on github easily. You can read the articles on Github deployment

Development and Customization

In this theme, we have used SCSS to develop and style fast. You can easily do it using Prepros. To edit SCSS code, follow the instruction:

1. Unzip docslab.zip (this is the template only file) and remember where is the folder location.
2. Install a SASS compiler, we recommend you to use Prepos 6, you can download it here.
3. Click on “Browse” to add project on the middle side.

Changing Primary and Secondary colors

You can change easily primary, secondary, text color and other colors from _variable.scss file. Open assets/scss/_variables.scss file and change the color that you want, example:

:root{
    --color-yellow: #FFAF29;
    --color-yellow-deep: #faa10c;
    --color-text: #DEDDDD;
    --color-heading: #fff;
    --color-quote: #dedddd;
}

Credits

Fonts and Icon Fonts

• Pacifico: https://fonts.google.com/specimen/Pacifico
• Poppins: https://fonts.google.com/specimen/Poppins
• Mulish: https://fonts.google.com/specimen/Mulish

• Feather Icons: https://feathericons.com/

Images

• Unsplash: https://unsplash.com/
• Pixels: https://www.pexels.com/

Plugins and libraries

• jQuery: http://jquery.com
• Fitvids: https://github.com/davatron5000/FitVids.js
• Fuse Search: https://github.com/krisk/Fuse
• Prism JS: https://prismjs.com/
• Medium Zoom: https://github.com/francoischalifour/medium-zoom
• Lazy Loading Disqus: https://samclarke.com/lazy-loading-disqus
• Lazy image loader: https://github.com/verlok/lazyload
• Isotope: https://isotope.metafizzy.co/
• imagesLoaded: https://imagesloaded.desandro.com/

Changelog

VERSION – 4.0.0: Release on 07 Jun 2021

. Compatible with ghost version 4.0
. Added support for public preview posts for members only posts
. Support for new price plan helper
. Updated deprecated functions
. Small bug fixes and performance improvements

CHANGED FILES
[+] style.css
[+] _common.scss
[+] _light-version.scss
[+] _blog.scss
[+] _membership.scss
[+] _header.scss
[+] default.hbs
[+] partials/navigation.hbs
[+] partials/members/members-navigation.hbs
[+] partials/members/pricing-tables/plan-free.hbs
[+] partials/members/pricing-tables/plan-monthly.hbs
[+] partials/members/pricing-tables/plan-yearly.hbs
[+] partials/members/subscriber-information.hbs
[+] partials/members/visibility-paid.hbs
[+] partials/subscribe.hbs
[+] package.json

VERSION – 1.0.3: Release on 14 Sept 2020

[+] CHANGED FILES:
    scss/_variables.scss
    scss/_header.scss
    scss/_blog.scss
    scss/_mobile-menu.scss
    scss/_notification.scss
    scss/_search.scss
    scss/_tag.scss
    style.css
    scripts.js
    locales/en.json
    partials/members/notification.hbs
    partials/members/visibility-content.hbs
    partials/notifications.hbs
    partials/author-card.hbs
    partials/footer.hbs
    default.hbs
    package.json

VERSION – 1.0.2: Release on 24 Aug 2020

[+] Changed files:
    partials/logo.hbs
    _variables.scss
    _header.scss
    style.css
    scripts.js

[-] deleted files:
    logo-dark.png

VERSION – 1.0.1: Release on 08 June 2020

- Changed files:
    featured-slider.hbs
    post.hbs
    package.json
    scripts.js

VERSION – 1.0.0: Release on 03 May 2019

[+] Initial Release