(256) 829-8652
clbranson@gmail.com

Palmetto Suggested Page Structure

Palmetto has a recommended page structure which will help you organize your pages and templates. You can read more about the different templates on this post. This schema roughly matches the themes on this site.

Page Subpage Description Parent Template
Home Page The special front page, showing the special header, featured property, and short description of blog posts. This is set as a Static Page Home Template
Listings A grid page serving as a directory for all listings. Grid Template
A Listing A page with a rental property listing. Listings Listing Template
A Listing A page with a rental property listing. Listings Listing Template
Blog When we set the home page as a static page (here, Home Page), we choose another page to be the index page for Blog posts.

Using Advanced Custom Fields

The Listing Page Template currently relies on the plugin Advanced Custom Fields to supply information for the Property Information sidebar within the template. Property information like cost or monthly rent and the number of bedrooms, bathrooms, and garage spaces.

Property Information On Listing Template
Property Information On Listing Template

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,
));
}

Palmetto Placeholder Images

The Palmetto theme uses a grid layout on multiple theme pages. By default, the featured image (if set) is used as a graphic on this grid. If no graphic is specified, one can set a website-specific placeholder.

Front Page Placeholder Image Location
Front Page Placeholder Image Location
Listings Page Placeholder Image Location
Listings Page Placeholder Image Location

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.

Palmetto Customizer Option: Placeholder Images
Palmetto Customizer Option: Placeholder Images