Documentation

Blooria

Enamul Haque

Enamul Haque

— 17 min read
Blooria

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.

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

  • Download theme file from ElectronThemes Dashboard
  • 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.

Here I have used Cyberduck to upload file on server and I used subdomain. That is why I used Blooria Folder

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

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

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}/

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

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

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

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

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 using cove comments for the posts. You can change your comment to Disqus or Cove.
  • Comment title: You can change title of the 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 an account to Cove
  • Show related posts: You can show/hide related posts section by this option.
  • Related posts title: You can change the title of related articles section

Custom Templates

A custom template is a default setting on Ghost. It can be a page template and a post template. We have created some custom pages and post templates for the theme. The page template is 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 titlePage URl
Membership/membership/
Account/account/

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 a native comment system. Only members of your website can comment on your post. To activate native comment:

  1. Go to the Settings > Membership > Commenting in the Ghost Admin.
  2. Change the Commenting level to All members or Paid-members only.
  3. Click on Save button

If you want to use other comment feature like Cove or Disqus. You can use. This theme supports both comment box. You will find both comment box in the partials folder in the theme file.

 

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

Images

Plugins and libraries

Changelog

VERSION – 4.3.5: Release on 01 October 2023

* ADDED: Header card improvements feature
* ADDED: New twitter icon
* Small css issues fixed and improvement performance

[+] CHANGED FILES
    assets/css/style.css
    partials/icons/social-icons/twitter.hbs
    page.hbs
    package.json

VERSION – 4.3.4: Release on 16 June 2023

* ADDED: FX Light box image popup feature
* ADDED: New menu navigation feature after SIX menu items
* Removed all deprecated code
* Small css issues fixed and improvement performance

[+] CHANGED FILES
    assets/css/style.css
    .github/workflows/deploy-theme.yml
    partials/header.hbs
    partials/navigation.hbs
    partials/related-posts.hbs
    partials/tag-special-1.hbs
    partials/tag-special-2.hbs
    custom-post-with-table-of-content.hbs
    partials/social-share.hbs
    partials/icons/social-icons/youtube.hbs
    partials/icons/social-icons/link.hbs
    partials/icons/dots.hbs
    partials/icons/copy.hbs
    tag.hbs
    post.hbs
    page.hbs
    default.hbs
    package.json

[+] ADDED FILES:
    partials/content.hbs
    partials/header-default.hbs
    partials/post-feature-image.hbs

[-] REMOVED FILES:
    partials/comments/cove-comments.hbs
    partials/comments/disqus-comment.hbs

VERSION – 4.3.3: Release on 06 January 2023

* ADDED: Images changed to Webp format
* ADDED: Line camp Added to post card
* ADDED: Custom option added for table of contents
* ADDED: Lightense plugin added for Image zoom in popup
* FIXED: Signin and Signup icon color issues fixed
* FIXED: TOC icon scroll issues fixed
* Small issues fixed and performance improved
* REMOVED: Medium Zoom plugin from JS

[+] CHANGED FILES:
    assets/css/style.css                 
    assets/scss/_header.scss             
    assets/scss/_variables.scss
    assets/scss/_blog.scss
    assets/scss/_common.scss
    assets/js/single.js                  
    partials/post-card.hbs    
    partials/author-card.hbs
    partials/featured-posts.hbs
    partials/page-banner.hbs
    partials/related-posts.hbs
    custom-post-with-table-of-content.hbs
    tag.hbs
    post.hbs
    author.hbs
    custom-authors.hbs
    package.json

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

VERSION – 4.1.0: Release on 05 April 2022

. 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

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

Read more