Menus should be at most one level deep for readability, and sections can be rearranged using the drag and drop interface provided by WordPress.

If you’d like icons to appear next to the menu items, you can use the CSS classes feature to insert Font Awesome icons. You can use the cheat sheet provided by Font Awesome here: http://fontawesome.io/icons/. As per the example above, if you’d like a home icon to appear ( ), then you should add fa fa-home to the classes option. If you wanted the Facebook icon (for example), then use fa fa-facebook. This will work for any of the icons on the cheat sheet.

The post Palmetto Navigation Menu appeared first on Palmetto.

Customization Overview

An overview of the customization options available. Once the Palmetto theme is chosen, from the WordPress dashboard go to Appearance -> Customize to access these options.

Site Identity

This section allows users to specify a logo, as well as a site title and description. If a logo is specified, it will be placed on the top navigation bar on the left-most side. The recommended logo size is 200px by 120px. If no logo is specified, the site name will appear. There is currently no option to display the site description.

Colors

The Palmetto theme allows you to choose link colors. These colors will change the appearance of links and buttons.

Header Image

This theme allows you to be specify a header image that will be displayed at the top of the front page. This is meant to highlight a featured real estate or rental property and should be used in conjunction with the Featured Property Header customization options as described below. Note, that this only applies to the home index page. Most other pages will have a header image consisting of a the featured image, which you can read more about here.

Menus

The Palmetto theme has only one designated menu, the top navigation bar. This is the user’s primary way to navigate the site. More information about this option can be found on this post.

Widgets

Sidebars are customizable in the Palmetto theme, like with most WordPress themes. The Palmetto theme has five sidebars: one for blog posts, one for page posts that use the Page With Sidebar Template (read more about that here), and three sidebars for the footer area which appears on all pages.

Static Front Page

Palmetto allows (and encourages!) users to specify a static page as the index page. This page should have the Home Page Template selected in order to use the many customization options described below. If your site also uses the blog feature in WordPress, you should make a page called Blog (or News, whatever) and specify that page as your posts page.

Contact Header

The Palmetto theme has a special header bar, which I’ve dubbed the Contact Header. This is where you can specify your contact phone number and email address, as well as links to various social media accounts. The information about social media accounts is also used in the footer by default.

Three Pane Featured (Home Page only)

The Palmetto theme has a special section on the Home Page template. This allows users to highlight special information that they want to be immediately conveyed to the end user. You can specify icons to accompany each panel, using the Font Awesome icon set. A cheat sheet for the icons can be found here: http://fontawesome.io/icons/.

Featured Listings Section (Home Page Only)

Another Home Page template feature, users can specify up to three feature real estate or rental property listings in the featured listings section. Users can specify the listing name, description, url, as well as property information like number of bedrooms, bathrooms, and garage spaces.

Placeholder Image Section

As described in this post, the Palmetto theme allows users to specify placeholder images in grids on the Home Page and Grid templates. See the linked post for more information.

Featured Property Header (Home Page Only)

To be used in conjunction with the Header Image customization option, the Palmetto theme allows users to specify a special property to be featured along with the header image.

The post Palmetto Theme Customization appeared first on Palmetto.

The post Palmetto Page Templates appeared first on Palmetto.

The post Palmetto Suggested Page Structure appeared first on Palmetto.

Listing Information

In order to use this plugin, specific fields must be specified for the information to show up properly. These fields are:

• monthly_rent
• number_of_bedrooms
• number_of_bathrooms
• number_of_cars
• availability
• contact_link

Gallery Images

If you’d like to use Advanced Custom Fields to display an Orbit slider to display images on the Listing Template, you should have the following fields. Note that there are several available options for this task.

• gallery_image_1
• gallery_image_2
• And so on up until…
• gallery_image_19

The PHP code to import the Listing Information fields is:
if(function_exists("register_field_group"))
{
register_field_group(array (
'id' => 'acf_listing-information',
'title' => 'Listing Information',
'fields' => array (
array (
'key' => 'field_5751ac42f64a3',
'label' => 'Cost',
'name' => 'monthly_rent',
'type' => 'text',
'instructions' => 'Cost or monthly rent of the listing',
'required' => 1,
'default_value' => '',
'placeholder' => '',
'prepend' => '',
'append' => '',
'formatting' => 'html',
'maxlength' => '',
),
array (
'key' => 'field_5751ac4ff64a4',
'label' => 'Number of Bedrooms',
'name' => 'number_of_bedrooms',
'type' => 'text',
'instructions' => 'Number of bedrooms for the listing',
'required' => 1,
'default_value' => '',
'placeholder' => '',
'prepend' => '',
'append' => '',
'formatting' => 'html',
'maxlength' => '',
),
array (
'key' => 'field_5751ac5bf64a5',
'label' => 'Number of Bathrooms',
'name' => 'number_of_bathrooms',
'type' => 'text',
'instructions' => 'Number of bathrooms for the listing',
'default_value' => '',
'placeholder' => '',
'prepend' => '',
'append' => '',
'formatting' => 'html',
'maxlength' => '',
),
array (
'key' => 'field_5751adc58559f',
'label' => 'Number of Cars',
'name' => 'number_of_cars',
'type' => 'text',
'instructions' => 'Number of car garage spaces for the listing',
'default_value' => '',
'placeholder' => '',
'prepend' => '',
'append' => '',
'formatting' => 'html',
'maxlength' => '',
),
array (
'key' => 'field_5751b1f0855a0',
'label' => 'Availability',
'name' => 'availability',
'type' => 'text',
'instructions' => 'Enter availability of the listing.',
'required' => 1,
'default_value' => '',
'placeholder' => '',
'prepend' => '',
'append' => '',
'formatting' => 'html',
'maxlength' => '',
),
array (
'key' => 'field_576861bd8a65c',
'label' => 'Contact Link',
'name' => 'contact_link',
'type' => 'page_link',
'instructions' => 'Provide a link to your contact page.',
'required' => 1,
'post_type' => array (
0 => 'all',
),
'allow_null' => 0,
'multiple' => 0,
),
),
'location' => array (
array (
array (
'param' => 'page_template',
'operator' => '==',
'value' => 'listing.php',
'order_no' => 0,
'group_no' => 0,
),
),
),
'options' => array (
'position' => 'normal',
'layout' => 'no_box',
'hide_on_screen' => array (
),
),
'menu_order' => 0,
));
}


The post Using Advanced Custom Fields appeared first on Palmetto.

The theme comes with a default placeholder image in greyscale meant to match any user-specified theme colors. These are located at assets/img/dft-placeholder-blog.jpg, for the blog placeholder image, and assets/img/dft-placeholder-listing.jpg, for the listing placeholder image. These images were made using Canva and the template can be found on my pblic profile page at https://www.canva.com/chrissybranso. These images can be customized to suite your specific theme colors. To use these images, upload them to wordpress, and changed in the WordPress customizer. More information about this can be found on the Palmetto Customizer Options post.

The post Palmetto Placeholder Images appeared first on Palmetto.

Advanced Custom Fields

As stated above, the Palmetto theme uses the Advanced Custom Fields plugin to populate certain areas of the Listings Page template, namely the right sidebar which discloses property information. You can also use ACF to create a Foundation Orbit slider. For each post, select the images that you’d like to appear on the slider. You can read more about how to use ACF with the Palmetto theme on this post.

Listings featuring the ACF method include:

• 2 Sample Listing Road

WP Slider Plugin

The WP Slider plugin is fairly easy to understand so I won’t go into details. If you choose to use this plugins, create your sliders, and insert the generated code into the page you’d like it to appear.

Listings featuring the WP Slider Plugin include:

• 3 Sample Listing Way
• 5 Sample Listing Road

NextGen Gallery Plugin

Like the WP Slider Plugin above, the NextGen Gallery plugin can be used to insert images into pages and posts.

Listings featuring the NextGen Gallery plugin incude:

• 4 Sample Listing Lane

In addition to adding slideshows and images to posts, it is highly recommended that you add a Featured Image to each of your listings. While this image is not currently used on the post, it is used on the Listings page.

Featured Images

Using Featured image alone does not allow an image to show up on the actual listing page. As you can see on the example page below, there is no image available on the actual listing page. However, it is still very important to set a featured image on ALL listing pages. This allows images to appear on the parent page, as recommended by the suggested site structure. The screenshot below shows you how to select a featured image.

Listings featuring only a featured image:

• 1 Sample Listing Ave

The post Listing Images appeared first on Palmetto.

This documentation site is hosted on GitHub.io. The static version of this WordPress site was created using the Simply Static plugin. Palmetto is open source and the code can be found at https://github.com/christinabranson/palmetto.

The images used on this site were obtained from Pixabay. The logos for both Palmetto and Bluffton Homes 4 Rent were designed by Kuug.

The post Palmetto Credits & Appreciation appeared first on Palmetto.