Getting Started

Newsportal 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 to you as soon as possible.

Template Information

Theme Setup

Newsportal theme setup is very easy. If you have already installed a server for Ghost you can easily setup Newsportal theme. If you don’t have server supported 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 the ghost dashboard. to do this

  • Log in into your Ghost admin panel.
  • Go to Settings > Theme > Upload a theme and upload “newsportal.zip
  • Click Activate.

Uploading the theme via (FTP)

Follow the instructions

  • Login to your FTP account.
  • Unzip the newsportal.zip file and copy newsportal 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 “Newsportal
  • 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 > General > Publication Identity

Favicon Icon

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

Publication Cover

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

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 > General > Site Meta Settings

Social Accounts

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

Primary Navigation

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

Secondary Navigation

Secondary Navigation is showing at the top of the header. To add a Secondary menu item, go to Dashboard > Settings > Navigation > Secondary 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 > Stuff > Invite people

Click on Invite people and you will get a new popup. You have to add an 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

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

Site Footer

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

Integrations and Custom 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, 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 are another very important and beta tester parts of Ghost. Ghost provides their beta updates here. Go to Dashboard > Settings > Labs

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

Migration Options

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

Routes

Routes.yaml 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 the header, we have used {{> header}} partials in folder partials/ header.hbs. In this file you can change the followings:

  1. Header Top
  2. Logo
  3. Search
  4. Dark Light Icon
  5. Primary Navigation

Header Top

In the header top, you can change the following parts from Header Top. Go to partials/header-top.hbs. You can change the following elements:

  1. Social Profiles
  2. Date
  3. Secondary Menu
  4. Subscribe links

For subscribe links, you will get the code. If you want to remove or change, you can do

{{#if member}} 
    <li><a href="/account/">{{t "Account"}}</a></li>
    <li><a href="#" data-members-signout>{{t "Signout"}}</a></li>
    {{else}}
    <li><a href="/signin/">{{t "Signin"}}</a></li>
    <li><a href="/membership/">{{t "Subscribe"}}</a></li>
{{/if}}

Logo

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

<div class="logo py-15">
    {{#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}}
</div>

Primary Navigation

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

Dark and Light version

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 version for default, go to default.hbs file and use data-theme="light" at line number 2

Use this line:

<html class="no-js" lang="{{@site.locale}}" data-theme="light">

Enjoy the light version of Newsportal theme

Footer

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

  1. About
  2. Recent News
  3. Tags
  4. Copyright text

Footer About

You can change the footer about text and logo from footer.hbs file. You will get subscribe form here also.

Recent News

You can add footer recent news. We have shown 3 recent posts in the footer. If you want to change the limit of posts, you can change at line number 50 . If you want to remove recent posts from footer, you can remove line 44 to 73

{{#get "posts" limit="3"}}

Recent Tags

At footer, we have showed 20 recent tags, If you want to change limit or remove the recent tags, you can do. Change limit from line number 74 at footer.hbs file

{{#get "tags" limit="20" include="count.posts" order="count.posts desc"}}

Copyright text

You can change at footer.hbs file line number 104

<p>{{t "© Copyright 2020 Newsportal. Published with "}}<a target="_blank" href="https://ghost.org/?via=electron-themes46">{{t "Ghost"}}</a></p>

Homepage

In homepage, you will get some sections.

  1. Featured Slider
  2. Latest Posts
  3. Trending News
  4. Weekly Top News
  5. Fashion News
  6. Business News
  7. Design, Lifestyle and Creative News
  8. International News
  9. Hot News

Featured Posts Slider

We have shown a section of 3 featured artcles on homepage. 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 3. If you want to increase or decrease the post limit, go to partials/featured-slider.hbs and edit limit="3".

{{#get "posts" filter="featured:true" limit="3" include="tags"}}

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

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

Latest posts

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

Posts on Tags

All posts are showing based on different tags. You can change tags in the following ways.

Trending News

Trending news comes from partials/tags/trending.hbs You can change the tag name from filter="tag:trending"

{{#get "posts" limit="9" filter="tag:trending" include="tags"}}

Weekly Top News

Weekly Top news comes from partials/tags/weekly-top.hbs You can change the tag name from filter="tag:weekly-top"

{{#get "posts" limit="7" filter="tag:weekly-top"}}

Fashion News

Fashion News comes from partials/tags/business.hbs If you want to change the tag name, go to the file and change the tag name from filter: filter="tag:business"

{{#get "posts" limit="5" filter="tag:fashion"}}

Business News

{{#get "posts" limit="5" filter="tag:business"}}

Design, Lifestyle, Creative News

Design News come from partials/tags/design.hbs. If you want to change the tag name, you can change from filter: filter="tag:design"

{{#get "posts" limit="5" filter="tag:design"}}

Lifestyle News come from partials/tags/lifestyle.hbs. If you want to change the tag name, you can change from filter: filter="tag:lifestyle"

{{#get "posts" limit="5" filter="tag:lifestyle"}}

Creative News come from partials/tags/creative.hbs. If you want to change the tag name, you can change from filter: filter="tag:creative"

{{#get "posts" limit="5" filter="tag:creative"}}

International News

International News comes from partials/tags/international.hbs. If you want to change the tag name, change the tag name filter: filter="tag:international"

{{#get "posts" limit="4" filter="tag:international"}}

Hot News

International News comes from partials/tags/hot.hbs. If you want to change the tag name, change the tag name filter: filter="tag:hot"

{{#get "posts" limit="all" filter="tag:hot"}}

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 titlePage URl
Membership/membership/
Account/account/
Signin/signin/
Signup/signup/

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

Post Template

  1. Post Fullwidth
  2. Post Left Sidebar
  3. Post Right Sidebar
  4. Post with table of content

We have used 3 posts page style in this theme. You can choose as following:

Custom Template: Post with table of contents

This is a new custom template of new updates (v3.0.0). You can select custom post template Post With Table Of Content to show the table of contents in your post. We have shown table of contents on a custom template. If you want to all the articles, replace {{> content}} from post.hbs file. Use table_contents="true" in the {{> content}} partials

{{> content table_contents="true"}}

Membership and Subscriptions

This is an awesome feature of Ghost. If you want to make money with publications, you can use Membership features of Ghost.

  • Connect your Stripe account
  • Add pricing to your monthly and yearly pricing

Stripe connection

Connect your stripe account to get the payment from your subscribers

Subscription Pricing

Add or change your subscription pricing from here

Portal Settings

  • Select pricing for Free, Monthly and Yearly
  • Customize your portal button

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

Portal Links

You can use portal links to your button to show portal popup.

  • Singin Portal: #/portal/signin
  • Signup Portal: #/portal/signup
  • Account Portal: #/portal/account

Use like this

<a href="#/portal/account">Account</a>

Portal Data Attributes

You can use portal Data Attributes to your button to show portal popup.

  • Singin Portal: data-portal="signin"
  • Signup Portal: data-portal="signup"
  • Account Portal: data-portal="account"

Use like this

<button data-portal="signin">Signin</button>

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: Dashboard > Settings > Email Newsletter > Email design

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

Pricing Tables

You may want to make changes to default feature points in your pricing tables. For that you have to edit the text (key points) in your free, monthly and yearly pricing plan.

Here we have used 3 pricing plans.

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

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

<li>{{t "Full access to post for subscribe"}}</li>
<li>{{t "Weekly email newsletter"}}</li>
<li>{{t "No advertising"}}</li>

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

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

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

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

Account Informations

Free Subscriber information

You can change the account information text on header page also. To change the information, go to custom-account.hbs. Go to line number 13 to change the information.

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

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 configured and add content api key on code injection

  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 the contact form, we have used Formspree for receiving contact form data.

  • Go to Formspree and Signup
  • Create Form
  • Copy your form’s endpoint code
  • Use the code in form action at line number 50
<form class="row" action="https://formspree.io/f/xxxxxx"  method="POST">

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 to partials/cove-comments.hbs file at line number 29
  • Publication ID. Copy this ID and paste to cove-comments.hbs file
  • 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 the directory where is your template.
  • Go to /content/themes/Newsportal/partials and open the next file: disqus-comment.hbs and git to line number 11 for disqus_shortname = newsportal-5;
  • Change with your shortname, in this case ‘example-shortname’;
  • Save the file and upload to your ghost installation.
  • Optional, you can verify if all is correct clicking Verify on disqus steps (where we get our shortname).

Github Deployment

Newsportal theme is ready for deployment 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 newsportal.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-primary: #f8633b;
    --color-dark-primary: #f75050;
    --color-secondary: #0b0b0c;
    --color-heading: #242428;
    --color-heading-two: #242428;
    --color-dark-heading: #333333;
    --color-paragraph: #666666;
    --color-paragraph-two: #666666;
}

Credits

Fonts and Icon Fonts

Icons

Images

Plugins and libraries

Changelog

VERSION – 3.0.1: Release on 28 Sept 2021
∙ Small bug fixes of locale
. Performance improvements


[+] CHANGED FILES
    default.hbs
VERSION – 3.0.0: Release on 26 Sept 2021
∙ Added: Table of comments
∙ Added: SVG Icons added
∙ Added: Cove comments added as default comment options
. Removed: Notification removed because ghost has a default notification
. Removed: Font Awesome and Other font icons removed for better performance
∙ Small bug fixes
. Performance improvements


[+] CHANGED FILES
    assets/js/scripts.js
    assets/css/style.css
    assets/scss
    custom-account.hbs
    custom-post-fullwidth.hbs
    custom-post-left-sidebar.hbs
    custom-post-right-sidebar.hbs
    custom-authors.hbs
    custom-contact.hbs
    package.json
    default.hbs
    page.hbs
    post.hbs
    tag.hbs
    author.hbs
    partials/sidebar.hbs
    partials/loop.hbs
    partials/featured-posts.hbs
    partials/latest.hbs
    partials/footer.hbs
    partials/header-top.hbs
    partials/header.hbs
    partials/loop.hbs
    partials/icons/search.hbs
    partials/post-card/big-thumbnail.hbs
    partials/post-card/business-thumbnail.hbs
    partials/post-card/fashion-thumbnail.hbs
    partials/post-card/news-big-thumbnail.hbs
    partials/post-card/news-small-thumbnail.hbs
    partials/post-card/short-thumbnail.hbs
    partials/post-card/small-thumbnail.hbs
    partials/post-card/top-reads-big-thumbnail.hbs
    partials/tags/trending.hbs
    partials/tags/hot.hbs
    partials/tags/international.hbs
    partials/tags/trending.hbs
    partials/sidebar/featured-news.hbs
    partials/sidebar/social-profiles.hbs
    partials/sidebar/subscribe.hbs
    partials/members/visibility-content.hbs
    partials/members/subscriber-information.hbs
    partials/related-posts.hbs
    partials/author-card.hbs
    partials/pagination.hbs
    partials/social-share.hbs

[+] NEW ADDED FILES
    partials/comments.hbs
    partials/icons/calendar-checked.hbs
    partials/icons/date.hbs
    partials/icons/facebook.hbs
    partials/icons/linkedin.hbs
    partials/icons/pinterest.hbs
    partials/icons/twitter.hbs
    partials/icons/call.hbs
    partials/icons/chat.hbs
    partials/icons/edit.hbs
    partials/icons/envelope.hbs
    partials/icons/globe.hbs
    partials/icons/home.hbs
    partials/icons/open-envelope.hbs
    partials/icons/quora.hbs
    partials/icons/user.hbs
    partials/icons/youtube.hbs
    partials/bredcrumb.hbs
    partials/content.hbs
    partials/post-header.hbs
    custom-post-with-table-of-content.hbs
    custom-subscribe.hbs

[+] MODIFIED FILE NAME
    partials/dicqus-comment.hbs → partials/disqus-comment.hbs

[-] DELETED FILES
    partials/search-popup.hbs
    assets/fonts
    partials/icons/loaderr.hbs
    partials/members/notification-scripts.hbs
    partials/members/notifications.hbs
VERSION – 2.0.0: Release on 19 April 2021
∙ Added: Support for Ghost 4.0
∙ Added: Support for 'Public preview' for members posts
∙ Added: Support for new {{price plan}} helper
∙ Updated: {{@site.locale}} helper replaces deprecated {{@site.lang}} helper
∙ Removed: Deprecated {{@labs.members}} helper
∙ Small bug fixes
.Performance improvements


[+] CHANGED FILES
    assets/js/scripts.js
    assets/css/style.css
    assets/scss/_dark-version.scss
    assets/scss/_footer.scss
    assets/scss/_news.scss
    assets/scss/_pagination.scss
    assets/scss/_signin.scss
    assets/scss/_membership.scss

    custom-account.hbs
    custom-post-fullwidth.hbs
    custom-post-left-sidebar.hbs
    custom-post-right-sidebar.hbs
    custom-account.hbs
    package.json
    default.hbs
    page.hbs
    post.hbs
    partials/members/notification-scripts.hbs
    partials/members/visibility-content.hbs
    partials/header-top.hbs
    partials/members/pricing-table.hbs
    partials/members/subscriber-information.hbs
    partials/sidebar/subscribe.hbs

[-] DELETED FILES
    partials/search-popup.hbs
VERSION – 1.1.4: Release on 09 March 2021
[+] CHANGED FILES
    scripts.js
    package.json
VERSION – 1.1.3: Release on 17 Dec 2020
[+] CHANGED FILES
    weekly-top.hbs
    package.json
    _header.scss
    _signin.scss
    _dark-light.scss
    _featured.scss

- some css issues fixed
VERSION – 1.1.2: Release on 17 Dec 2020
[+] CHANGED FILES
    scss/_variable.scss
    scss/_style.scss
    custom-post-fullwidth.hbs
    partials/footer.hbs
    partials/header.hbs
    partials/members/notification-scripts.hbs
    locales/en.json

[+] Newly ADDED
    scss/_notification.scss
    partials/members/notifications.hbs

- Notifications restored
VERSION – 1.1.1: Release on 19 Nov 2020
[+] CHANGED FILES
    package.json
    custom-signup.hbs
    post.hbs
    page.hbs
    author.hbs
    tag.hbs
    custom-contact.hbs
    custom-tags.hbs
    partials/author-card.hbs
    partials/footer.hbs
    partials/post-card/small-thumbnail.hbs
    partials/related-posts.hbs
    partials/sidebar/featured-news.hbs
    scripts.js
    scss/_author.scss
    scss/_button.scss
    scss/_featured.scss
    scss/_footer.scss
    scss/_signin.scss
    scss/_single-news.scss
    scss/_dark-version.scss

[+] NEWLY ADDED
    LazyLoad scripts

[-] DELETED FILES
    Removed custon notifications
VERSION – 1.1.0: Release on 02 Oct 2020
[+] CHANGED FILES
    package.json
    partials/featured-posts.hbs
    partials/latest.hbs
    partials/footer.hbs
    partials/loop.hbs
    partials/post-card/big-thumbnail.hbs
    partials/members/notifications.hbs
    partials/members/notification-scripts.hbs
    partials/post-card/business-big-thumbnail.hbs
    partials/post-card/business-thumbnail.hbs
    partials/post-card/fashion-thumbnail.hbs
    partials/post-card/news-big-thumbnail.hbs
    partials/post-card/news-small-thumbnail.hbs
    partials/post-card/short-thumbnail.hbs
    partials/post-card/small-thumbnail.hbs
    partials/post-card/top-reads-big-thumbnail.hbs
    partials/related-posts.hbs
    partials/tags/international.hbs
    partials/post-card/top-reads-big-thumbnail.hbs
    partials/related-posts.hbs
    partials/sidebar/social-profiles.hbs
    partials/social-share.hbs
    partials/tags/hot.hbs
    partials/tags/trending.hbs
    assets/js/scripts.js
    SCSS Styles

[+] NEWLY ADDED
    partials/icons/copy.hbs
    Notifications for CARD, Expired Links

[-] DELETED FILES
    partials/post-card.hbs
VERSION – 1.0.0: Release on 27 July 2020
[+] Initial Release