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
- 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
- We recommend a plugin like Regenerate Thumbnails to make the images compatible with Neville.
To get things started:
- You’ll need to create a new page and add our custom page template
- Go to
WP Administration Panel > Settings > Front page displaysand select
A static page (select below). You can also select a page to display your latest posts/blog with the
Posts pageselect option (for example, create a page called
Blogand select it in this option). Don’t forget to click the
Now you can add/position sections in the Customizer.
- Go to
WP Administration Panel > Appearance > Customizeand the Customizer will open up.
- Click on
Front Page Sections > Add or Configure Sectionsand you’ll be able to add sections by clicking on
- You can also reposition sections by drag and dropping them.
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:
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:
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.
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.
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.
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).
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:
- Category link
- 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.
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;
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).
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.
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
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:
<a href="LINK" target="_blank">
<img width="980" height="90" src="URLFOR980X90PXIMAGE"
sizes="(max-width: 980px) 100vw, 980px"
You’ll need to change the
URLFOR980X90PXIMAGE to your urls, make sure the images are of different sizes.
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).
WP Administration Panel > Posts > Add New:
- Enter a title and you can see that it will also appear in the Title Design editor, in real time, as you type.
- 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).
- 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).
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
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.
Neville has a widgetized footer, with 3 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
add_filter( 'neville___disable_credits', '__return_true' );
Neville currently has 5 menu locations. You can see each location here:
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
- you need to create a
- add a social url in the
URLfield, example “https://www.facebook.com/acosmin”
Link Textfield 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