Theme Instructions

Composition

Composition is super flexible WordPress theme for creating Business, Portfolio, Store or Blog website.

Installation

  1. Log in to your WordPress dashboard. This can be found at yourdomain.com/wp-admin
  2. Go to Appearance -> Themes and click on the Install Themes tab.
  3. Click on the Upload link.
  4. Upload the zip file that you downloaded and click Install Now.
  5. Click Activate.

Installing your theme - Step 1 Installing your theme - Step 2 Installing your theme - Step 3

Required Plugins

The following plugins are required in order to build a website like the demo:

  1. _JetPack_ - The JetPack plugin is required in order to fully utilize the features of this theme. Key JetPack-supported features include: JetPack Custom Post Type Portfolio, JetPack Custom Post Type Testimonial, Tiled Galleries, Site Logo, and Infinite Scroll.

Recommended Plugins

The following plugins are recommended in order to build a website like the demo:

  1. _Sell Media_ - The Sell Media plugin is recommended if you want to show your products on the homepage, like in the demo. Sell Media allows you to sell photos, prints and downloads directly from your WordPress website.
  2. Easy Google Fonts - The Easy Google Fonts plugin is recommended if you want to change body and headline fonts on your website. After activating the plugin, visit Appearance -> Customize -> Typography.

Demo Content

Optional: You can download a demo content file from below:

  1. Portfolio Demo
  2. Business Demo
  3. Store Demo
  4. Blog Demo

To import the demo content, visit Tools -> Import.

In many cases just importing the demo content will not work since you will also have to make some manual configurations. Please go through this documentation to fully understand how the theme works in order to customize it to fit your needs.

Initial Setup

Install Jetpack

Please refer to Jetpack's offical documentation for installation instructions.

Once Jetpack is installed and active:

  • Visit JetPack -> Settings -> Appearance and activate Tiled Galleries.
  • Visit JetPack -> Settings -> Writing and activate Custom Content Types for Portfolios and Testimonials.

Set the homepage

  1. Visit Pages -> Add new and create a new page called Homepage. Select Homepage Template under Template option. Composition Homepage
  2. Visit Pages -> Add new and create a new page called Blog. Composition blog
  3. Visit Settings -> Reading and select "A static page." Next, set the Homepage that you created above as your Front page and set your Blog page as the Posts page. Composition Reading Settings

Customization Overview

Composition can be configured in a number of different ways to achieve the different layouts as shown in the four demo sites. Customization happens in two places:

  1. Customizer - Visit Appearance -> Customize -> Homepage Options. This panel is where you'll customize all of the main homepage options, colors, typography, logos, widgets and menus. Composition Customizer
  2. Front Page - The featured image on your Front Page will become the header image on your homepage. If you add text or shortcode to the editor, it will be shown at the top of your homepage. For example, the screenshot shows the a Front Page with a featured image as the header, text and shortcode for showing the Search box for Sell Media ([sell_media_search]) Composition Front Page
Create a Website Like the Portfolio Demo

Composition Portfolio

Creating a website like the portfolio demo is a three-step process: 1. Create a Front Page under Pages menu and select the Homepage Template under Template select box. 2. Go to Settings -> Reading and select your Front Page you just created as Static Front page. This should be your new homepage. If you want to run a blog, create a blog page and select that page under the Static Posts page in the same Settings -> Reading page. 3. Enable Jetpack's "Portfolio" Custom Content Types if you haven't done so already. 4. Add Portfolio entries on Portfolio -> Add New. Be sure to give each Portfolio item a title, a featured image, and a description. 5. Visit Appearance -> Customize -> Homepage Options -> Homepage Portfolio. Select "Show" from the list of display options. Select "Masonry Layout" from the list of style options. Change the number of Portfolio items to 6. Click Save & Publish.

Composition Portfolio

Create a Website Like the Business Demo

Composition Business

Creating a website like the business demo is a multi-step process:

  1. Create a Front Page under Pages menu and select the Homepage Template under Template select box.
  2. Go to Settings -> Reading and select your Front Page you just created as Static Front page. This should be your new homepage. If you want to run a blog, create a blog page and select that page under the Static Posts page in the same Settings -> Reading page.
  3. Enable Jetpack's "Portfolio" and "Testimonial" Custom Content Types if you haven't done so already.
  4. Add Portfolio entries on Portfolio -> Add New. Be sure to give each Portfolio entry a title, a featured image, and a description.
  5. Add Testimonial entries on Testimonials -> Add New. Be sure to give each Testimonial entry a title (client name), a featured image, and a description. The description becomes the actual testimonial.
  6. Visit Appearance -> Customize -> Homepage Options -> Homepage Slideshow and upload some images. The slideshow replaces the header section/image. All slideshow images will be resized to 2400px wide by 1200px tall, with mobile breakpoints. Low resolution images will not look good in the slideshow area, so please upload images of adequate size for the best display. Composition Business Slideshow
  7. Give each image in your slideshow a title, a caption, and optionally provide a Slideshow Link URL. The title and caption will be displayed as an overlay on the image in the slideshow. Composition Business Slideshow
  8. Visit Appearance -> Customize -> Homepage Options -> Homepage Call To Action. Select "Show" from the display options and add your call to action title, message, button text and button url. Composition Business Slideshow
  9. Visit Appearance -> Customize -> Homepage Options -> Homepage Portfolio. Select "Show" from the list of display options. Select a layout, set the number of Portfolio items to show and click Save & Publish. Composition Portfolio
  10. Visit Appearance -> Customize -> Homepage Options -> Homepage Services. Select "Show" from the list of display options and add a title and an image for each service you want to showcase on the homepage. Composition Business Services
  11. Visit Appearance -> Customize -> Homepage Options -> Homepage Blog. Select "Show" from the list of display options and optionally give the blog section a custom title. Composition Business Blog
  12. Visit Appearance -> Customize -> Homepage Options -> Homepage Testimonials. Select "Show" from the list of display options and optionally give the testimonials section a custom title. Composition will display the three most recent testimonials that you add in the Testimonails -> Add New page. Composition Business Testimonials
  13. Visit Appearance -> Customize -> Homepage Options -> Homepage Clients. Select "Show" from the list of display options and add a title and an image for each client you want to showcase on the homepage. Composition Business Clients
  14. Visit Appearance -> Customize -> Homepage Options -> Homepage Contact Info. Select "Show" from the list of display options and add a title, address, phone and office hours. A Google Map will automatically be displayed based on the provided address. Composition Business Contact
  15. Visit Appearance -> Customize -> Widgets and add widgets to be displayed at the bottom of the footer. These widgets will be shown throughout your website. Composition Business Widgets
Create a Website Like the Store Demo

Composition Store

Creating a website like the store demo is a multi-step process:

  1. Enable our free Sell Media plugin if you haven't done so already.
  2. Edit your Front Page and set a featured image. This image will become the header image on your homepage. The title becomes the big text, and any text or shortcode to the editor will be shown at the top of the featured image. For example, the screenshot below shows the a Front Page with a featured image as the header, text and shortcode for showing the Search box for Sell Media ([sell_media_search]) Composition Front Page
  3. Select the Homepage Template under Template select box while saving your Front page.
  4. Go to Settings -> Reading and select your Front Page you just created as Static Front page.
  5. Visit Appearance -> Customize -> Homepage Options -> Homepage Store. Select "Show" from the display options and choose either "Collections" or recently added "Items" to show. If you don't activate the Sell Media plugin, the Homepage Store option will not be displayed in the Customizer. Composition Store Sell Media
  6. Visit Appearance -> Customize -> Widgets and add widgets to be displayed at the bottom of the footer. The store demo shows a Text Widget, Sell Media Featured Items and Sell Media Recent Items widgets respectively. These widgets will be shown throughout your website. Composition Store Widgets
Create a Website Like the Blog Demo

Composition Blog

Creating a website like the blog demo is dead simple. Visit Settings -> Reading and assign your "Front Page displays" option to "Your Latest Posts", if thats not already set. All your posts should appear on the homepage.

Composition Blog Setting

Gallery Layouts

If you have JetPack enabled, you'll have 7 different gallery layouts to select from including:

  1. Thumbnail Grid
  2. Tiled Mosaic
  3. Square Tiles
  4. Circles
  5. Tiled Columns
  6. Masonry Gallery
  7. Slidehow

There gallery layout options appear in the right-side of the Gallery Editor after you're selected your images. Jetpack Gallery Types

Menus

To learn how to use Menus, please see this video.

This theme supports two menu locations:

  1. Header Primary Menu (in header)
  2. Footer Social Menu (in footer above the credits) Sider menus

Composition can display both dropdown and "mega menus." A Mega Menu is a menu dropdown that spans the full width of the page with horizontal columns. The "Demos" menu link on all the Composition Demo sites is a Mega Menu.

You can create your own Mega Menu by creating a menu item with three levels of nesting. Please see the screenshot below for help creating you own Mega Menu. Only the Header Primary Menu Location supports a Mega Menu.

Composition Mega Menu

The configuration above would result in the following Mega Menu layout:

Composition Mega Menu Example

Here is how we recommend you setup your menus:

  1. Use the Header Primary menu for all your main site navigation links (Home, Portfolio, Services, Store, About, etc.) Try to limit the number of list items to no more than 5. Any more than that and it creates a confusing UX for your visitors.

  2. Use the Social menu for social media links. Give each link a name and paste the urls to your social media websites. The theme will automatically convert the link to an icon for these sites: WordPress, Facebook, Twitter, Dribbble, Google Plus, Pinterest, Github, Tumblr, Youtube, Flickr, Vimeo, Instagram, Codepen and LinkedIn.

Featured Images

If you are using the Portfolio Content Type from JetPack as we recommend, you will want to make sure to set a Featured Image for all entries.

Changelog

1.0.2 - December 05, 2016 - Fixed slideshow flickering issue in Safari

1.0.1 - November 16, 2016 - Customization option for header text color

1.0 - October 7, 2016 - Initial release

Credits

Based on Underscores https://underscores.me/, (C) 2012-2015 Automattic, Inc., GPLv2 or later

normalize.css https://necolas.github.io/normalize.css/, (C) 2012-2015 Nicolas Gallagher and Jonathan Neal, MIT