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: support@electronthemes.com Our support team will reply you within 6 hours.

Template Information

• Name: Blooria
• Author: Electronthemes
• Platform: Ghost
• Demo: Blooria
• Created: 06 May 2020
• Last Update: 19 November 2022 See Changelog
• Version: 4.3.2

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  Dashboard > Settings Icon > Design > Change Theme > Upload Theme > Upload
• 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 following:

• Title
• Description
• Site Timezone
• Publication Language

Logo

We have used SVG Logo for the theme . You can change SVG Logo from Dashboard > Settings > Design > Brand > Publication Logo

Favicon Icon

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

Publication Cover

You can use the publication in your native language. To change the language of your publication site, your theme must have support for translation. To change langauge:

Language

This is for showing the site bookmark images. If you upload a cover image, it will be in your site bookmark. Go to Dashboard > Settings Icon > Design > Brand > Publication Cover

1. Go to Settings > General > Publication Language and click on Expand
2. Change the default language en with your language code
3. You can find all the language code here: HTML Language Code Reference

Site Meta Settings

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

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

Social Accounts

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

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 > Settings > Navigation

Create a Post

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

1. Feature Image
2. Post Title
3. Post content

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 > Settings > 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 fields for code injections. 1. Site Header and 2. Site Footer

• Site Header is for load the scripts or style in the header
• Site Footer will load the scripts or style in the footer

Go Dashboard > Settings > Code Injection

Integrations

Integrations are another cool feature of Ghost. You can connect a lot of third-party plugins or API using integrations. To check the integrations,

1. Login to Admin panel
2. Go to Dashboard > Settings > Integrations.
3. Click on + Add custom integration button and add a name for creating integration
4. You can use Content API Key or Admin API Key or API URL

Labs

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

1. Import Content
2. Export your content
3. Delete All Content
4. Redirects
5. 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

Logo

You can change the site main logo follow the instruction: Settings > Design > Site Design > Brand > Publication Logo

Dark Logo Mode

If you want to use Dark logo, you can change it from your custom settings. You will find the settings :

Settings > Design > Site Design > Site-Wide > Dark Mode Logo

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

Dark, Light and Auto Mode

We have used dark version by default. When you will install the theme file on your ghost server, you will get your website as dark version.

If you want to use Light and Auto version for default, you can change it from your custom settings. Auto version depend on your device color scheme mode. if the device has selected dark mode, you will get auto dark and device has selected light mode, you will get auto light. You will find the settings Settings > Design > Site Design > Site-WIde > Select Color Scheme

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 footer copyright text from Dashboard > Settings Icon > Design > Site-Wide > Site Footer

if you change the site footer box text . you will get the output on footer copyright text.

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 display off /on Featured Post Slider from homepage, please go to Settings > Design > Homepage > Show featured Post

Latest posts

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

Pagination Type

If you want you can change the pagination type ( Button Mode default ) just select one. You will find the settings: :

Settings > Design > Homepage > pagination Type

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

Post Layout

Show Author

If you want to display show / hide  Author from your single post , please go to Settings > Design > Post > Show author

Show Related Posts

If you want to display off /on Show Related Posts from post, please go to Settings > Design > Post > Show Related Posts

Related Posts Title

You can change the Related Posts Title from custom settings. You will find the settings:

Settings > Design > Post > Related Posts Title

You get the change output below single post page :

Custom Settings

From v4.1.0, we have released custom settings for Site-Wide, Homepage, Post. You can easily select your options from Settings > Design > Site Design

Site-Wide Settings

• Dark Mode Logo: You can Upload from here Dark Mode Logo. For enable dark mode logo you have upload first publication logo (light mode logo) for default.
• color scheme: You can change your theme color from Dark to Light or Light to Dark for default
• Search content API: Add your content API for the search field. When you add to this field, your search option will show and work.
• Site footer: You can change footer copyright text.

Homepage Settings

• Show featured posts: You can off/on hompage featured slider by this option.
• Select pagination: You can select Pagination or Load More. By default, Load more option will work

Post Settings

• Show author: You can show/hide your author from your single post by this option.
• Comments Type: By default we are use cove comment for the posts. You can change your comment Disqus or Cove.
• Comment title: You can change title of comment section
• Disqus shortname: If you select Disqus Comment for your comment option, you need to add Disqus Shortname. You can learn more from [Comments Section]
• Cove publication id: Add your cove publication ID from this field. To get cove publication id, create account to Cove
• Show related posts: You can show/hide related posts section by this option.
• Related posts title: You can change title of relates articles section

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.

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

Membership and Subscriptions

The membership page is helping your customer to understand the plan and compare the differences between your offers. Here are the step by step instructions:

Create Membership page

1. Create a new page and open the page settings panel from the right side of the page
2. Select the page template: Membership at the bottom dropdown
3. Publish the page

Create Tiers and show on membership page

1. Go to Settings > Membership in your Ghost Admin
2. Go to MEMBERSHIP TIERS at the bottom
3. Connect your Stripe Account if you don’t have Stripe connected
4. Expand Premium position and click on +Add tier to add new tier name, description, list of benefits, price for monthly and yearly.
5. Add tier to activate
6. Now, go to portal settings, you can control enable and disable tiers appearing on the membership page.

Create Account Page

1. Create a new page and open the page settings panel from the right side of the page
2. Select the page template: Account at the bottom dropdown
3. Publish the page

Search Options

We have created real-time search options the theme file. You can activate the search easily.

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

After collect the Content Api Key we go to : Settings > Design > Site-Wide and insert to below search content API box.

Contact form

In contact form, we have used Formspree for getting form data. Put your formspree endpoint URL Settings > Design > Site wide > Contact form endpoint url

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

Comments

Ghost has no default comment sytem. We need to third-party comment box like Disqus or Cove. This theme supports both comment box. You will find both comment box in the partials folder in the theme file.

Cove Comment

Cove is popular comment system for ghost. You can easily manage comments for members and paid members posts. It is a premium comment sytem. We have a setup for cove comments. You easily change with your comments.

• Create account in Cove.chat and Login
• Click on +Create a New Account and add a name
• Copy the publication ID and paste it in Settings > Design > Site Design > Post

• Publication ID. Copy this ID and paste to Cove publication field.

• Replace publication id with your account code

Disqus Comment

We have used discus comments for this theme. We have used our own disqus account. You can change easily with your Disqus shortname. Follow the process to create your Disqus account and get a short name.

1. You can create your Disqus code in the next url: http://disqus.com/admin/create/
2. Add a short-name for Website Name
3. Your unique “Disqus URL” is your shortname copy that name and click finish registration.

• Go to Settings > Design > Site Design > Post and Select Disqus from Select comment select option.
• Go to Settings > Design > Site Design > Post > Disqus shortname;
• Change with your shortname, in this case ‘example-shortname’;
• Save.

Disable Comments from site

If you want to disable comments from your posts, select Disable from Settings > Design > Site Design > Post > Select Comment. If will disable comments from your site

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 must have installed Nodejs and SASS on your computer.

• Open theme file in your editor like VSCode or Sublime Text
• Open terminal in the theme folder
• Run command npm run sass

Alternatively, 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.3.2: Release on 19 November 2022

* FIXED: Membership tiers issue fixed
* Small issues fixed and performance improved

[+] CHANGED FILES:
    assets/css/style.css
    assets/scss/_light-version.scss
    assets/scss/_blog.scss
    partials/members/pricing-tables/plan-monthly.hbs -> partials/members/pricing-tables/plan-monthly-yearly.hbs
    partials/members/pricing-table.hbs
    package.json

[-] deleted files:
    partials/members/pricing-tables/plan-yearly.hbs

VERSION – 4.3.1: Release on 13 November 2022

* FIXED: Dark light switcher issues fixed
* FIXED: Featured slider spacing issues fixed
* FIXED: Fullwidth image issues fixed for TOC articles
* Other issues fixed and performance improved

[+] CHANGED FILES:
    assets/css/style.css
    assets/scss/_light-version.scss
    assets/scss/_toc.scss
    partials/featured-posts.hbs
    package.json

VERSION – 4.3.0: Release on 31 October 2022

* Compatible with Ghost 5.x
* Native search and Native Comment feature
* Remove all Ghost 4.x deprecated code
* Multiple fonts feature
* Table of contents with posts
* Custom settings
* CSS bug fixed
* Performance improved

[+] CHANGED FILES:
    assets/css/style.css
    assets/css/style.scss {All style file has changed}
    custom-contact.hbs
    package.json
    post.hbs
    author.hbs
    tag.hbs
    partials/header.hbs
    partials/navigation.hbs
    partials/subscribe.hbs
    custom-authors.hbs
    partials/author-card.hbs
    partials/featured-posts.hbs
    partials/footer.hbs
    partials/page-banner.hbs
    partials/post-card.hbs
    partials/related-posts.hbs
    partials/tag-post-card.hbs
    partials/featured-posts.hbs

[+] NEW ADDED FILES:
    partials/comments/native-comments.hbs
    partials/google-fonts.hbs
    custom-post-with-table-of-content.hbs

. Added Custom Option
. Updated deprecated functions
. Small bug fixes and performance improvements

CHANGED FILES
[+] style.css
[+] _light-version.scss
[+] _variables.scss
[+] _search.scss
[+] _header.scss
[+] default.hbs
[+] index.hbs
[+] post.hbs
[+] partials/comments/cove-comments.hbs
[+] partials/footer.hbs
[+] partials/header.hbs
[+] partials/logo.hbs
[+] partials/members/notification.hbs
[+] partials/related-posts.hbs
[+] partials/author-card.hbs
[+] partials/loop.hbs
[+] partials/search-popup.hbs
[+] package.json

NEW ADDED FILES
[+] partials/comments/disqus-comment.hbs

. 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