Installation & Setup: Getting Started with Oleander
Please note: This FAQ Article is specifically for the Oleander theme.
Whether you're brand new to WordPress or would just like a quick lesson on basic Oleander theme features, you're in the right place! Below, we'll go through a number of how-tos regarding standard theme functions, from installing the theme to setting up your sidebar and more.
To skip directly to a specific section in the article, please use this index:
- Installing the theme
- Creating a post
- Creating a page
- Creating a category page
- Homepage settings
- Creating a main menu
- Adding a featured image
- Adding social icons
- Enabling the featured area slider
- Setting up your promo boxes
- Setting up your sidebar
- Setting up the footer area
INSTALLING THE THEME
So you've purchased Oleander & you're ready to get started-- great!
When you purchase an Oleander license from Creative Market & download the theme package, you will receive a zipped folder titled "Oleander-A-Blog-Shop-Theme".
Unzip this first folder.
Within the unzipped theme package, you will find a number of folders such as demo content, documentation, logo image files, etc. There is also 1 additional zipped folder within, titled "oleander.zip".
Important: DO NOT unzip this "oleander.zip" folder! This particular .zip folder should remain zipped.
"oleander.zip" is the main theme.
Within your WordPress Dashboard, navigate to Appearance > Themes.
Click the "Add New" button at the top-left of the page > Click the "Upload Theme" button at the top.
Click "Choose File" > find your zipped "oleander.zip" file > Click the "Install Now" button.
Once the theme is successfully installed on your WordPress, you can "Activate" it via the installation page or via Appearance > Themes to switch over and begin using your Oleander theme!
Please note: If you try installing the entire zipped theme package or another incorrect file, you'll likely receive this error message:
"The package could not be installed. The theme is missing the style.css stylesheet. Theme install failed."
If you receive this error message, please be sure that you're installing the ZIPPED file titled "oleander.zip".
CREATING A POST
Oleander has the possibility to create 4 different types of posts: standard, gallery, video, and audio.
In order to activate these post options, you'll first want to ensure you've installed & activated the required Vafpress Post Formats UI plugin. This plugin comes included with the theme.
When you first activate Oleander, you should notice a banner notification across the top of your dashboard advising you to install specific required & recommended plugins.
Install & activate the Vafpress Post Formats UI plugin by clicking the "Begin installing plugins" link. Check the boxes next to the plugins > select "Install" from the drop-down menu > and click "Apply".
After, follow the same steps yet select "Activate" from the drop-down menu (plugins need to be both installed AND activated to function).
To create a new post, go to WordPress Dashboard > Posts > Add New.
Above your content box & toolbar, you'll see a series of tabs titled Standard, Gallery, Video, and Audio. Select whichever tab you'd like your post format to be in. Each tab will give you different input boxes depending on the content you'd like to add.
A standard post is the default post type.
You can add text and images to your post using the tools and content box.
Example of a standard post: http://solopine.com/oleander/photoshoot-in-central-park/
A gallery post allows you to create a slideshow-type gallery at the top of your post. After clicking the "Gallery" tab to choose this post format option, click the "Pick Images" button within the "Gallery Images" box that has appeared. Select whatever images you'd like from your WordPress Media Library.
Example of a gallery post: http://solopine.com/oleander/visiting-the-old-farm/
A video post displays a video at the top of your post. You can share videos from nearly all video hosting sites, such as Vimeo or Youtube. Simply copy & paste the video's URL, oembed code, or embed code into the special input box. When you preview or publish your post, the video will appear.
Example of a video post: http://solopine.com/oleander/explore-pacific-northwest/
An audio post allows you to share a music or audio track and displays it at the top of the post. Like the video post, simply copy & paste the track's URL, oembed code, or embed code into the special audio input box. When you preview or publish the post, the track will appear.
Example of an audio post: http://solopine.com/oleander/niki-the-dove/
Once you've determined your desired post format, entered your title, and added your content, remember to assign at least 1 category to your post. Additionally, also ensure you assign a featured image to the post.
Once you're finished preparing your post, you can click "Preview" to preview how your post will look once published onto your site, click "Publish" to have it appear on your site, or click "Save Draft" to save your post as it is, though not publish it yet.
To learn about how to add the Continue Reading button seen on the demo site to your posts, check out this article: How do I add the "Continue Reading" button to posts in Oleander?
CREATING A PAGE
A standard, static page is similar to creating a post in many ways, and is ideal for creating an About Me or Contact Me section to your website.
To create a new page, navigate to WP Dashboard > Pages > Add New.
Like a post, you can enter a page title, add content, and assign a featured image.
Additionally, you have the option of choosing between a number of page templates/layouts via the drop-down menu on the right titled "Template":
- Sidebar page layout (default)
- Full-width page layout.
- Full-width page with slider & promo boxes layout
- Sidebar page with slider & promo boxes layout
Once you've published your new page, it will not automatically appear in your main menu. For a tutorial on adding items to your main menu, please check out this FAQ article: How do I set up my navigation menu?
CREATING A CATEGORY PAGE
A category page is a dynamic page that pulls in all of your posts assigned with a particular category. You do not create a category page like you would a standard page (described above)-- a category page is generated by WordPress after you add a category to your main menu.
First, ensure you've assigned the category to at least 1 post. Then, navigate to Appearance > Menus and click the drop-down box heading titled "Categories" on the left of the page. Below, your categories will be listed. Check the box next to your desired category and click "Add to Menu". Be sure to save. When you click on the newly-created menu item, it will take you to that category's page.
For more information on creating a category page, please check out: How do I set up my navigation menu?
ADJUSTING THE LAYOUT OF YOUR CATEGORY PAGES:
Category Pages which display all posts related to a particular category, Tag Pages which display all posts related to a particular tag, Author Pages which display all posts related to a particular author, etc., are called "Archive Pages". To change the page layout of your archive pages, head to Appearance > Customize > General Settings > and choose from the layout options within the "Archive Layout" section.
Here, you can also enable or disable the sidebar from displaying on Archive pages.
Your homepage is the first page visitors will see when they arrive at your website. By default, the homepage will be the page that also displays all of your posts, beginning with the most recent. We call this feature the "post feed".
Not seeing your post feed on the homepage? Check out: Show post feed on homepage
To customize how your homepage looks, including its layout, colors, enabling/disabling the sidebar, etc., navigate to WordPress Dashboard > Appearance > Customize
Under the various drop-down tabs on the left of this screen, you'll find loads of ways to customize your homepage & website in general. For example, within the "General Settings" tab, you can choose your homepage's post layout and enable/disable the sidebar.
Be sure to explore the various options within this Customizer section. The live preview on the right will show you a preview of how each adjustment will visually affect your site.
If you'd like your homepage to instead be a static page and have your post feed display on another page entirely, please check out our tutorial here: How to create a static homepage & separate blog page.
CREATING A MAIN MENU
Setting up Oleander's main menu is quite simple! For a walk-through on how to go about it as well as more specific how-to tutorials, please check out: How do I set up my navigation menu?
ADDING A FEATURED IMAGE
Assigning a featured image to your posts is very important, as the featured image is what the theme & other web functions use to visually represent the post in various situations.
For a walk-through on where and how to assign a featured image, please take a
look at: How do I add a Featured Image?
Additionally, even if you don't want the featured image to display at the top of your post, you should still assign a featured image. Once that's done, you can hide the featured image from the top of your post by navigating to Appearance > Customize > Post Settings > And checking the box next to "Hide featured image from top of post".
ADDING SOCIAL ICONS
Navigate to Appearance > Customize > Social Media Settings.
Here, you will see a list of social networks followed by a text input box. If you'd like to have a social icon for a particular social network, you can type in your username for that particular network.
Please note that you do not need to insert your profile's full URL into this box unless prompted to do so. Only your related username is required. The username you enter will be added into a pre-set URL for the network.
For example, if you enter the Instagram username "solopine" within Social Media Settings, your Instagram icon will automatically link to the URL: https://www.instagram.com/solopine
Once you enter your username into a particular social network's text box, its icon will appear in your top-bar & footer social icon areas. If you leave a social network's box blank, the social icon will not appear in the top-bar or footer areas.
To add the social icon widget to your sidebar or footer area, you can do so within WP Dashboard > Appearance > Widgets.
Don't see your desired social network? There are tons of social media sites out there and we're unfortunately not able to include built-in options for all of them in the theme. However, don't fret! We have a tutorial written up on how to add custom icons to your theme here: How do I add social media icons to Oleander?
ENABLING THE FEATURED AREA SLIDER
SETTING UP THE SLIDER:
Oleander's featured area slider is a large area toward the top of the homepage where you can feature eye-catching images linking to your posts. There are a few steps to ensure your slider works perfectly:
- Enable your slider: To enable it, you can navigate to WP Dashboard > Appearance > Customize > Featured Area Settings > and enable the slider here.
- Ensure your posts have featured images assigned: Oleander gives you two options for assigning an image to represent a post in the slider. One option is to simply assign a Featured Image to your post. By default, this is the image that the slider (and many other sections around the theme) will pull in to represent your post. For more information, check out: How do I add a Featured Image? Oleander also allows you to assign a specific image to represent the post in the slider separate from your post's Featured Image. To assign an alternate slider image, navigate to your post's create/edit screen and look in the meta box titled "Page Options". Here, you can choose your "Custom Slider Image" and/or insert "Custom Slider Sub-title" text.
- Have your slide images display in their best quality: Ensure that the source images are at least 1900px in width & 530px in height. If your featured images are smaller than 1900x530 pixels, WP will upscale them to fit the slider's container size which may result in image graininess.
CHOOSING YOUR SLIDER'S POSTS:
Within Appearance > Customize > Featured Area Settings, you have 3 options for choosing which posts appear in your featured area slider:
- All latest posts: By default, the slider will display all of your latest published posts.
- Posts from specific category: From the drop-down menu titled "Select Featured Category", you can also choose a particular post category to display in your slider.
- Specific posts/pages: In the box beneath the title "Select featured post/page IDs", you can determine exact posts and/or pages to display in the slider. To learn how to identify a post or page's ID, check out: How to determine a post, page, or category ID
SETTING UP YOUR PROMO BOXES
The 3 boxes below the featured area slider on Oleander's demo site are called Promo Boxes. These boxes allow you to draw special attention to any post, page, or general URL you'd like.
To set up your promo boxes, navigate to Appearance > Customize > Promo Box Settings.
Here, you can enable/disable the promo boxes and input your various promo box preferences.
For each of the 3 promo boxes, you have the option to enter a title, select an image, and input the URL you'd like that specific promo box to link to.
SETTING UP YOUR SIDEBAR
A sidebar is a vertical content area that displays to the right of your main content/post area. You customize your sidebar by stacking up different widgets that display a variety of things.
ENABLING/DISABLING THE SIDEBAR:
To enable/disable the sidebar on your homepage and/or your archive pages (category pages, tag pages, etc.) navigate to Appearance > Customize > General Settings. Here, you can check or uncheck the boxes next to "Disable Sidebar on Homepage" and "Disable Sidebar on Archives".
To enable or disable the sidebar on your Posts, you can do so from within the post's create/edit screen. This allows you to enable the sidebar on your singular post page on a post-by-post basis.
To enable or disable the sidebar on your static Pages (pages created within WP Dashboard > Pages) you can do so within the page's create/edit screen using the "Templates" drop-down menu.
ADDING WIDGETS TO YOUR SIDEBAR:
To add, remove, or edit your sidebar widgets, navigate to Appearance > Widgets.
On the left, you will see a list of the available widgets to choose from.
On the right, you will see a few different widget areas in the theme.
To add a widget to your sidebar, simply drag & drop a widget on the left into the widget area titled "Sidebar".
EDIT WIDGETS IN YOUR SIDEBAR:
Once you've dropped a widget into the Sidebar widget area, click on its heading. A drop-down will appear and you can make any necessary adjustments to the widget's settings. From this widget setting drop-down, you can also delete the widget.
To position widgets within the sidebar, drag and drop them above or below each other.
SETTING UP THE FOOTER AREA
The footer area is the lower portion of the theme that will appear on all pages of your site. It can include:
- 3 widget areas
- Social icon area
- Instagram footer area
- Copyright text area
WIDGETIZED FOOTER AREA:
Similar to the section above regarding "Setting up your Sidebar", the footer has three side-by-side widget areas titled "Footer 1", "Footer 2", and "Footer 3" where you can add in widgets of your choosing. You can add multiple widgets in each of the three sections, however, for ideal display, we recommend inserting one widget per footer widget area.
SOCIAL ICON AREA:
The footer's social icon area is directly connected with Oleander's top-bar social icon area. To choose which social icons you'd like to appear, enter your username for each social network platform within Appearance > Customize > Social Media Settings.
For more information, please reference the section above titled "Adding Social Icons".
INSTAGRAM FOOTER AREA:
Similar to the section above regarding "Setting up your Sidebar", the footer has a widget area titled "Instagram Footer" where you can add in a widget to display your Instagram images in a full-width slider.
The widget is simply called "Instagram" and is made available after installing & activating the plugin called WP Instagram Widget.
To add the Instagram widget, navigate to Appearance > Widgets.
On the right, you'll see the theme's different widget areas. One of which is the widget area titled "Instagram Footer".
Drag the "Instagram" widget from the left of this screen into the "Instagram Footer" widget area. To edit the widget's settings, click on the widget's heading once it's been placed in a widget area. A drop-down area will appear.
To have your Instagram footer display like the Oleander demo site's, set the "Number of photos" option to be "8".
COPYRIGHT TEXT AREA:
At the very bottom of the theme is a bar which features a text area to include copyright or disclaimer text. You are not required to include a copyright or disclaimer statement. In fact, you can type whatever you'd like in this area!
To edit the text in this Copyright Text area, look within
Appearance > Customize > Footer Settings.
For help troubleshooting issues in Oleander or to see some fun customization tutorials, check out all of Oleander's FAQ Articles here! Oleander Articles