Neville

Neville WordPress Theme Documentation

Things to know

IMPORTANT: Use a child theme. Child themes are the recommended way of modifying or adding new styles to Neville. You can download one from here.

You should use images of this size:

  • Recommended but not really needed 1920x1080px
  • Recommended 1170x530px
  • You can also add tall images, some of these images are used in masonry style grids. Just make sure they have at least a width of 1170px.
  • We recommend a plugin like Regenerate Thumbnails to make the images compatible with Neville.

Home Page

To get things started:

neville-front-page

  1. You’ll need to create a new page and add our custom page template Front Page
  2. Go to WP Administration Panel > Settings > Front page displays and select A static page (select below). You can also select a page to display your latest posts/blog with the Posts page select option (for example, create a page called Blog and select it in this option). Don’t forget to click the Save Changes button

Now you can add/position sections in the Customizer.

  1. Go to WP Administration Panel > Appearance > Customize and the Customizer will open up.
  2. Click on Front Page Sections > Add or Configure Sections and you’ll be able to add sections by clicking on Add Section
  3. You can also reposition sections by drag and dropping them.

Featured Posts

You can make a feature a post by clicking on the Featured Article option when you edit or create a post. You can find this option in the top right corner:

neville-feature-post

Slider Section

The Slider section will only display featured posts by date. In the following image you can see that this section has two parts, the actual slider and statics (you can disable one of these parts if you like). Statics are posts below the Slider which can’t slide:

neville-slider

You can add up to 4 slides and 6 statics. A total of 10 featured posts, which you will need to add/have if you want to take full advantage of this section.

Based on the options you can calculate how many featured posts you need, check the How many slides? & How many statics? options for exact numbers.

Category Section

This section will display the most recent posts in a selected category. Before you use this section, make sure you have enough posts in the desired category. Currently you can select to show up to 9 posts.

Header Area
This area will display the selected Category name, description and a menu. (see image, point 2)

You can set a description for any category by going in WP Administration Panel > Posts > Categories and adding some text in the Description textarea. If the category already exists, you can edit/add a description by moving your mouse hover a category and clicking on the Edit link. It’s recommended that you don’t add long descriptions, a few words, 35-40 letters.

The Header menu (see image, point 2.1) displays a selected menu. The idea behind this area is to create/add menus with sub-categories, but you can add any links you want. Any menu created in WP Administration Panel > Appearance > Menus will be available for selection.

Articles area
As mentioned above, only the most recent posts will display in this area and you can show up to 9 posts. Options are pretty straightforward (see image, point 1), mostly you can disable parts of an article (like date, thumbnail, sharing).

Sidebar
This is not really a WP sidebar because you can’t add widgets in it (see image, point 3). It currently has 3 parts, Featured/Popular posts, two buttons for rss/category links and an AD (this last option is available only by downloading/installing Neville Extensions).

Disabling this sidebar will expand the Articles area to 3 columns.

Featured/Popular posts area (see image, point 3.1) will display posts which are featured/popular in the selected category, not global.

Buttons (see image, point 3.2) displays only two buttons:

  1. Category link
  2. Category RSS link, if someone wants to subscribe.

AD (see image, point 3.3) is an option which is added by Neville Extensions. You need the plugin installed and activated for this option to show up. Recommended AD size: 300x250px, responsive.

neville-category-section

Line Section

This section is used to add some space and create a distinction between sections. The current option allows you to select a small and larger margin-bottom (see image, point 1):
Small margin: 30px;
Larger margin: 55px;

neville-break-line

Blog Section

Displays your most recent posts, categories don’t matter. This section has no options, to change how many posts to display, go to WP Administration Panel > Settings > Reading > Blog pages show at most (changing this option will have effect globally in archive type views).

Instagram Section

This section is available only if you download and activate Neville Extensions. Before you start using this section or widget, you will need to authorize ACOSMIN to access your Instagram photos and set up an API key.

To do this, go to WP Administration Panel > Settings > Instagram Settings and follow the instructions.

Ads Section

This section is available only if you download and activate Neville Extensions. It can be used to display responsive Ads (even Adsense).

Recommended sizes for:

Section (remember to set a Banner type/width):

  • 980x90px
  • 728x90px
  • 468x60px

If you want to add an image ad and make it morph from 980x90px (desktop) to 728x90px (tablets) and 300x250px (mobiles) use the following code:

You’ll need to change the URLFOR980X90PXIMAGE to your urls, make sure the images are of different sizes.

Widget:

  • 300x250px

Title Design

This option is available only if you download and activate Neville Extensions. It will give you the ability to add em and strong html tags to any post title. You can do this with both new posts and old posts (edited).

Go to WP Administration Panel > Posts > Add New:

  1. Enter a title and you can see that it will also appear in the Title Design editor, in real time, as you type.
  2. After you decide on a title, you can go to Title Design and select the words you want to be italic or bold. (our demo uses only italic).
  3. Save/Update the post. This can be done with existing posts, it doesn’t have to be a new one.

IMPORTANT: If you want to add new words in a title, edit the original one and the Title Design field will update automatically (you’ll just have to remake the words italic/bold again).

Sharing Icons

Neville adds support for Jetpack’s Sharing Buttons module. You will need to enable this option, go to WP Administration Panel > Jetpack > Settings > Sharing and enable Sharing Buttons.

After that, click on Configure your sharing buttons and follow the instructions.

IMPORTANT: Neville works best with Icons only selected for Button style. This is also needed in case you want to add sticky sharing buttons next to posts.

IMPORTANT: To enable sticky sharing buttons next to posts, go to Customizer > Theme Settings > Post and enable Show side sharing buttons. The same can be done for Pages.

Footer

Neville has a widgetized footer, with 3 sidebars.

neville-footer-sidebars

Notice: If no widgets are added in any of the sidebars, this area will not display.

If you don’t want to share the love 🙂 and disable our credits line, you can add the following line at the bottom of your child theme’s functions.php file:

add_filter( 'neville___disable_credits', '__return_true' );

Menus

Neville currently has 5 menu locations. You can see each location here:

neville-menus

You can add menus in these locations by going in your WP Administration Panel > Appearance > Menus. You can then create menus and assign them to any of those locations.

Mobile Menu: The offset mobile menu (hamburger menu) is actually a sidebar in which you can add a “Custom Menu” widget or any other widgets you want. This is the only menu appearing in a mobile environment. It has nothing to do with the Header Top, Header Top Social and Primary locations.

Supported sub-menus in the following locations:

  • Header Top: 0
  • Header Top Social: 0
  • Primary: 1 level
  • Footer: 0
  • Footer Social: 0

To add items in the Social menus

  1. you need to create a Custom Link
  2. add a social url in the URL field, example “https://www.facebook.com/acosmin”
  3. the Link Text field doesn’t really matter, but you need to add something in it, example “Facebook”

Notice: You can leave the locations empty if you don’t want the menus to display.

Notice: If you don’t want to create two social menus, you can just add one in Header Top Social and Footer Social. The same thing can be said about Header Top and Footer locations.