Documentation for Moment

ATTENTION: This documentation is about the new version of Moment, if you are using the legacy version please visit its documentation page here

Server Requirements

If you already have WordPress installed, it means that you meet the minimum server requirements and you can perfectly install this theme without any issues. To get the most out of your website though, you should get in touch with your web host and ask them if they meet the following criteria:

PHP version 7.4 or greater.
MySQL version 5.6 or greater OR MariaDB version 10.1 or greater.
HTTPS support.

Prerequisites

Ignition Framework

This theme requires our free Ignition framework plugin to be installed. Simply visit the Downloads area, download the Ignition Framework plugin, upload it through your Dashboard > Plugins > Add new and Activate it.

It really doesn’t matter if you install the theme or the plugin first. Just make sure to install both in order to get the whole functionality.

Here you can find an overview of how to download and install the plugin.

Theme installation

Installing the theme is a very simple process. Go to your dashboard under Appearance > Themes > Add new, click Upload Theme and upload the zip file. Once uploaded click Install Now and then the Activate Theme link. Here is a detailed overview on how to download and install the theme.

Once the theme is installed and activated you will be forwarded to the theme’s onboarding page.

Here you will be prompted to install and activate the Ignition Framework plugin if you haven’t done so already. Here you can also install our free custom blocks plugin, GutenBee. Through the onboarding page you have access to many useful links, such as the theme’s documentation, our knowledge base articles and direct links to our support hub.

In the Sample Content tab of the onboarding page you can install and activate all the plugins required to import the sample content and proceed with its installation. More info on that on the next section.

NOTE: The only plugin required for the theme to work properly is the Ignition Framework plugin, all other plugins are entirely optional if you don’t need their functionality or are not planning on importing the sample content. You can safely skip installing and activating them if you are sure you don’t need them.

How to import the sample content

If you like what you see in our demo website you can simply import the sample content. This means that a close approximation of our demo website will be imported in your WordPress installation. Now all you have to do is replace the content of these pages with yours. Importing the sample content can help serve as a basis on which you can continue to build and expand your site, however keep in mind that this procedure is entirely optional.

Check out a generic overview of the sample content import procedure.

The procedure:

In your WordPress dashboard visit Appearance > Theme Options > Sample Content.
Click Install and then Activate for each of the required plugins.
Click the Get Started button and in the next screen the Import Demo Data button.

NOTE: Due to the nature of the import mechanism some links may link back to our demo website. If you are not sure how to update / change these links simply get in touch and we’ll help you out.

Image sizes

Web page loading times are greatly affected by the size of your images. For best results make sure to use images with the recommended dimensions as described below:

Main post thumbnail: 870x580px
Item: 615x410px
Large Item: 1170x780px
Article Media: 510x510px
Mini-cart items: 160x160px
Masonry listing normal: 400x425px
Masonry listing double: 800x850px
Masonry listing tall: 400x850px
Masonry listing wide: 800x425px
Single post left/right content thumb: 555x600px
Single post Centered fullwidth image: 1920x1000px

NOTE: If for any reason you want to change the dimensions of any of the predefined image sizes you have to use a plugin. Here is a guide describing the process.

NOTE: All image sizes are the minimum recommended, adding larger image sizes will result in cropping them to fit these sizes. In order to alter WooCommerce sizes check this guide.

Setting up site-wide sections

It’s considered a good practice to set up the areas of your website that you won’t be editing a lot in the future, like the general site layout, the header, footer and some secondary functionality.

General Site Options

You can change your general site options under Appearance > Customize > Site Options. Under the Layout section you can control your site’s, blog’s and single blog post’s layout, as well as the site width and content/sidebar column ratio. The layout can then be overridden in each post/page individually. Under the Colors tab you can select the basic color palette for your installation and add a background image. Finally under Typography you can select the ideal font pairing from a full list of Google Fonts and customize font properties for key elements on desktop and mobile devices alike. You also have the option to disable Google Fonts altogether.

Read this knowledge base article for more information regarding the site options.

Moment features a normal header with a custom menu layout.

With the theme’s default menu layout enabled the menu will be presented in the form of a button which when clicked reveals a sidebar menu which slides in from the right.

Logo

The recommended maximum width of your logo is 200px (or double that if you want a retina ready logo) while you can use any height you want. To upload your logo go to Customize > Site Identity. You can upload two logos. The normal and the alternative one. The alternative logo can be used if you want a different logo to appear when the header layout is set to Transparent under Customize > Header > Layout. In the theme’s demo we don’t use a logo image.

Learn more about the header and its options.

Main Menu

If you are not familiar with WordPress menus here is a detailed guide.

Navigate to Customize > Menus. Enter a menu name (It can be anything you like) and click on the Create Menu button. In the next page click the Add Items button and start adding items to the menu. Now all you have to do is assign this menu to a location through the Menu Locations section, check the Main menu location and you are done. Your navigation menu should be now visible on your website.

The page title section

Under the page title section you can choose to show or hide the page title and or subtitle.

Utilities

In the utilities section you will configuration options for various small theme features, such as the built in weather display capability, toggle for the theme’s lightbox, the block editor dark theme, back to top button, social sharing and block widget support.

Read here for more information regarding the theme’s utilities.

For more information check out this knowledge base article about available customization options.

Creating posts

Creating posts on Moment is exactly the same as any other theme. Moment offers a few extra layout related options listed below.

Post templates

Moment comes with four distinct post templates to help you create beautiful posts. The templates can be selected from the Summary metabox on the right hand side toolbar.

Content on the right (default): This template displays the featured image on the left and the content on the right. See an example of the layout here.
Content on the left: This template displays the featured image on the right and the content on the left. See an example of the layout here.
Centered fixed width image: This template displays the content centered with the featured image on top. See an example of the layout here.
Centered full width image: This template displays the content centered with a full width featured image on the top. See an example of the layout here.

Listing image sizes

To create the front page’s layout Moment allows you to select the image size for each post. This way you can draw the reader’s attention to certain posts by making them appear, larger, taller or wider.

There are four available image sizes to choose from. If you don’t want to choose one, or you want to have a fluid homepage layout with sizes changing on every reload you can set it to random.

Custom block styles

Moment also offers the pull left and pull right block styles for the Core Quote block which allows you to pull a quote left or right depending on the post content template you have selected. The Wide block style available for the Core Embed block, the GutenBee Video and GutenBee Video Embed blocks will make a video full width on the Content on the right/left post templates. Examples of both block styles in action can be found in this post.

Setting up the pages

Homepage

Due to its unique design, Moment features only a single page, the homepage which will list all our posts.

The homepage has the Homepage wide template applied to it and its top/bottom content padding is disabled under Page Settings > Content Area.

Content wise the page features a single Post Types block with the Overlay block style active displaying 9 posts. The pagination is enabled and set to Load more button. The column numbers here are irrelevant since the masonry layout of the front page is automatically generated by the Packery JavaScript library.

Common Features

Shortcodes

The Ignition Framework offers a multitude of custom shortcodes these are:

Custom menu: [ignition-custom-menu name=”your menu name”]

Site search: [ignition-site-search]

Date: [ignition-date]

Weather: [ignition-current-weather id=”your-location-id(optional)”]

Minicart button: [ignition-minicart-button]

Language switcher: [ignition-language-switcher]

Icon link: [ignition-icon-link]

Instagram Feed: [ignition-instagram-feed]

WooCommerce search: [ignition-wc-search]

For more information have a look at this knowledge base article about shortcodes and their usage.

Page options

All themes offer six different templates which modify the location and appearance of the sidebar and the main content’s width.

Additionally pages have a common set of options which allow you to customize the appearance of the page title section, toggle breadcrumbs and more.

All settings are inherited from Customizer. So you can actually set some global settings and if you wish change certain pages to have different behavior.

Here is a detailed explanation of the available templates and their options.

WooCommerce

Ignition Framework based themes are compatible with WooCommerce giving you the ability to create awesome online stores which perfectly match the appearance of the rest of your site.

WooCommerce is an optional plugin. You don’t need to install it if you are not looking to build an online store.

After activating WooCommerce it will create and set some default pages. These will serve as your Shop, Cart, Checkout and My Account pages.

The framework offers various customization options both for the main product listing page under Customize > WooCommerce > Product Catalog and for single products under Customize > WooCommerce > Single Products.

Learn more about the WooCommerce integration and the options offered.

Global Sections

With the Global Sections custom post type included in all Ignition Framework based themes users can create content which can be easily reused in more than 15 key theme locations. For example users can create a newsletter subscription call to action box and immediately display it above the footer on all (or some) posts and pages, or create a banner ad an easily add it between posts in post listings etc.

Learn more about Global Sections here.

Blog page

This is you main blog page. You can create a new page and set it as your posts page under Customize > Homepage Settings. You can customize it under Customize > Blog from the Archives section.

The theme provides special widget areas for your posts listings, pages and shop. You can use a plugin/module like Jetpack’s widget visibility to hide or show widgets for certain pages, posts or products.

Page builder support

Ignition Framework based themes work seamlessly with popular page builders like Elementor, Divi, Beaver builder and more to cater to the needs of those who like to build things visually.

Support

If you need help during the initial installation and setup of this theme feel free to get in touch and we will get back to you within 24 hours to help.