This is the online presence documentation for the turn-key system by UJ Software. It describes how to get into the various business accounts as well as how to change some of the contents without needing any developer skills.

TABLE OF CONTENTS

• Accounts
  • iFastnet (Web hosting)
  • Add Google Master Account to your device(s)
  • Take ownership of the Google Master Account
  • Log in to Google My Business, Microsoft Bing Places, Yelp, and Instagram accounts
  • Manage the Facebook Business Page
  • OpenWeatherMap
• WordPress
  • Login to User Account
    • Securely Share Login Details
  • Theme and Core Functionality
    • Theme Customization Options
    • Change Cover Image
    • Theme Demonstration
    • Theme Footer Widget Layout
    • Theme Shortcodes
    • Theme Animations
  • Plugins
    • Contact Form 7 (Contact Us Form)
    • MailPoet 3 Premium (Newsletter)
    • PublishPress Future (Expire Posts)
    • Site Kit by Google (Analytics)
    • We’re Open! (Opening Hours)
  • Custom Post Types
    • Theme Settings
    • Alerts
    • Bookings
    • Contacts
    • Events
    • Generic Posts (FAQs, Fundraiser, News)
    • Testimonials
    • Displaying Custom Post Types
  • Media
    • Image Slider

iFastnet

Unless otherwise arranged, iFastnet is your web hoster. They house your domain name, WordPress installation, and domain email addresses to name a few. To login to your account, go to iFastnet Login and use the login credentials from the separate spreadsheet.

Once you are logged in, you can manage the various areas of your hosting account like account details, services, domains, support tickets, and invoices.

cPanel

Your hosting plan is managed via the de facto standard cPanel management platform. In order to get into cPanel, you click on the services button on the home screen. On the next screen, you click on the service name which is usually "Super Premium (Monthly)". Finally, click on "Login into cPanel" under "Actions" on the left-hand side. This opens a new tab for cPanel.

There is usually no need for you to go there regularly as most menu entries require some technical knowhow. Here are the most important cPanel entries in the order they appear on the menu:

We created the email address info@yourdomain.com for you. Here you can add more real email addresses as you see fit.

We created a forwarder from info@yourdomain.com to one or more of your existing email addresses. Here you can add or modify more forwarders.

This menu entry checks if everything is configured correctly to ensure your emails are deliverable.

The file manager for your hosting account.

The graphical MySQL database administrator.

The manager for your associated domain names.

The Secure Socket Layer (SSL) certificate manager.

Add Google Master Account to your device(s)

• Open your browser and go to https://www.google.com

• Click on your symbol in the upper right corner to open the dialog (1)
• Select "Add another account" (2)
• Enter Google account email address (see separate password sheet)
• Enter Password (see separate password sheet)
• Depending on the browser, there could be additional prompts....

Note: Until the account has been updated with your phone number at the end of the project, all security verifications will come through us.

Take ownership of the Google Master Account

Change Recovery Phone Number

1. Open your Google Account.
2. Switch to the Master Google Account.
3. Under "Personal info," select Contact info  Phone.
4. Change your phone number: Next to your number, select Edit  Update number.
5. In the box that appears, follow the instructions.

Which number to use

Use a mobile phone that:

• Gets text messages
• Belongs only to you
• You use regularly and keep with you

Change Recovery Email Address

1. Go to your Google Account.
2. On the left navigation panel, click Personal info.
3. On the Contact info section, click Email.
4. Change (or delete) your recovery email: Next to your email, select Edit .
5. Follow the steps on the screen.

Which email to use

Choose an email address that:

• You use regularly
• Is different from the one you use to sign in to your Google Account

(See the full description directly at Google Support.)

Log in to Business Accounts

If you haven't done so already, follow the instructions on how to add the Google Master Account to your device.

Google My Business

• Go to Google My Business
• If you don't see the business listed, switch the account by clicking on the round symbol in the upper right corner. Then select the Google Master Account.

Microsoft Bing Places

• Go to Microsoft Bing Places for Business
• Sign in using your Google Account and pick the Google Master Account

Yelp

• Go to Yelp
• Continue with Google and pick the Google Master Account
• Note: Yelp is the only service that doesn't accept a logo for the avatar image. You will not be able to perform actions like replying to reviews unless you have uploaded an avatar image with a discernable face.

Instagram

• Go to Instagram
• Log in with credentials from spreadsheet

Manage the Facebook Business Page

We created a Facebook business Page for you unless you already owned one. Customers can like or follow a Page to get updates from you. Anyone with a Facebook account can help manage one, as long as they have a role on the Page. We usually add all Facebook accounts you gave us with the manager role to the Page.

All managers will receive notifications and emails when customers like or follow the Page. Customers can also send messages or leave reviews. It is important to stay on top of these customer-interactions since they are often time-sensitive.

When managers interact with the Page, they can choose to do this as the Page owner or through their personal profile; the standard is Page owner. You want to update the Facebook Page frequently in order to keep the followers engaged. Any change to the Page is automatically pushed out to the followers.

Your Facebook Business and Instagram pages are linked. This allows cross-posting from Facebook to Instagram automatically. Here are a few links that describe how to cross-post:

• Meta: Crossposting from Instagram to Facebook
• Guiding Tech: How to Post from Facebook to Instagram at the Same Time
• Influencer Marketing Hub: How to Cross-Post to Instagram From a Facebook Page

OpenWeatherMap

OpenWeatherMap gives you free access to current weather data for any location on Earth, including over 200,000 cities. The data is frequently updated based on the global and local weather models, satellites, radars, and a vast network of weather stations.

We opened an account with OpenWeatherMap on your behalf and created an API key. It allows 1,000 API calls per day, enough for 20 different weather maps throughout your webpage. The credentials are on your spreadsheet.

For some businesses, it makes sense to show the current weather condition or even a forecast on the webpage. We will turn off this feature should it not benefit your line of business.

Login to User Account

Go to https://yourdomain.com/wp-login.php ; replace "yourdomain" with your proper domain name. Then login with the username "author" and the password from your spreadsheet. The admin account should only be used for website maintenance.

Note: Make sure to use a strong password since this login screen is exposed on the internet.

Securely Share Login Details

If you want us to log into your site to assist with an issue then emailing the password is not the safest practice. There are better ways to do it.

• Never send a password by email.
• Never send us your own login details. Create a new temporary account instead.
• Always delete the temporary account when we’re done helping you.
• Make a full website backup before we work on it.

Add temporary WordPress admin access

WordPress provides a way for you to give us admin access without emailing a password.

1. Go to Users > Add New in the WordPress dashboard to create a temporary account for us.
2. Use ujsoftware for Username.
3. Use info@ujsoftware.com for Email.
4. Use UJ Software for First Name.
5. Leave Send User Notification checked.
6. Choose Administrator for Role.
7. Check 2FA Grace Period (if this field is on your form)
8. Click Add New User then tell us you’ve made an account for us (don’t send the password).
9. Make a reminder to delete this account when we’re done helping you.

WordPress will email us a link that we can click to choose a new password. This way the password itself is never sent via email. The link will expire and we will not store the password. Instead, we’ll log in and choose “Remember Me”. You’ll then delete the account when we’re done.

Theme Customization

The video shows all available theme customizations without going into any detail. Most of the settings will be done by us when we create your website.

Change Cover Image

Follow these steps to change the cover image:

• From the WordPress Menu
• Media -> Add New
• Drag and Drop the new image
• Wait until you can see the thumbnail of the image
• Appearance -> Customize
• Header Banner
• Button "Add new image"
• Choose the image from the media library
• Follow screens to Crop and Save
• Button "Publish"

Note: WordPress always leaves the original uploaded image file and only works with copies. Everything can be undone if necessary.

Theme Demonstration

The following section shows the layout of all major elements with the currently selected fonts and colors. You can look at your own demo under https://yourdomain.com/theme-demo/; replace “yourdomain” with your proper domain name. 

<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="left" title="Tooltip on left">Left</button>

<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="top" title="Tooltip on top">Top</button>

<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Tooltip on bottom">Bottom</button>

<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-placement="right" title="Tooltip on right">Right</button>

Theme Footer Widget Layout

Theme Shortcodes

The following shortcodes are supported by this theme:

• [cts_site_owner_company]:
  UJ Software
• [cts_site_owner_email]:
  info@ujsoftware.com
• [cts_site_owner_phone]:
  (571) 599 - 1977
• [cts_site_owner_fax]:
  (571) 555 - 1234
• [cts_site_owner_location_address]:
  1 Main St
  Suite 100
  Chantilly, VA 20151
• [cts_site_owner_year_founded]:
  2000
• [cts_site_owner_company_age]:
  25
• [cts_site_owner_mailing_address]:
  Note: Returns [cts_site_owner_location_address] when empty)
  PO Box 230252
  Centreville, VA 20120
• [cts_full_location_address]:
  UJ Software
  1 Main St
  Chantilly, VA 20151
  info@ujsoftware.com
  (571) 599 - 1977
  (571) 555 - 1234
• [cts_site_owner_contact1]:
  Uwe Jacobs
• [cts_site_owner_contact1_email]:
  info@ujsoftware.com
• [cts_site_owner_contact1_phone]:
  (571) 599 - 1977
• [cts_site_owner_contact2]:
  Uwe Jacobs
• [cts_site_owner_contact2_email]:
  info@ujsoftware.com
• [cts_site_owner_contact2_phone]:
  (571) 599 - 1977
• [cts_site_owner_contact3]:
  Uwe Jacobs
• [cts_site_owner_contact3_email]:
  info@ujsoftware.com
• [cts_site_owner_contact3_phone]:
  (571) 599 - 1977
• [cts_full_contacts]:
  Uwe Jacobs
  info@ujsoftware.com
  (571) 599 - 1977
• [cts_social_google_my_business]
• [cts_social_facebook]
• [cts_social_bing_places]
• [cts_social_yelp]
• [cts_social_instagram]
• [cts_social_youtube]
• [cts_social_twitter]
• [cts_social_linkedin]
• [cts_social_nextdoor]
• [cts_social_angi]
  These shortcodes show icons with a link to the various social media and business listings.
• [cts_social]:
  This shortcode shows all icons for social media and business listings.
• [cts_review_google]
• [cts_review_facebook]
• [cts_review_yelp]
• [cts_review_angi]
  These shortcodes show icons with a link to the various social media and business review submissions.
• [cts_review]
  This shortcode shows all icons with a link to the various social media and business review submissions.
• [cts_recaptcha_key_v2]:
  xxxxxxxxxxxxxxxxxxxxxxx
• [cts_recaptcha_key_v3]:
  yyyyyyyyyyyyyyyyyyyyyy
• [cts_creation_date]:
  March 14, 2022
• [cts_modification_date]:
  January 20, 2023
• [admin_url]:
  https://ujsoftware.com/wp-admin/
• [domain_name]:
  ujsoftware.com
• [link url="#" newwindow="0"]label[/link]:
  label
• [site_url]:
  https://ujsoftware.com

Theme Animations

The following animations are available in this theme:

Note: Use with class .animated.

Contact Form 7

The Contact Form 7 plugin is the defacto standard for contact forms under WordPress. We install the below contact form either on the homepage or if your webpage has one, on the contact page. The name, email, and subject fields are mandatory, the message is optional. The form is protected by an invisible Google ReCaptcha.

The Submit button triggers an email to the info@yourdomain.com address with the contents of the form in the email body and informs the user that the message has been sent.

The plugin Flamingo, from the same developer as Contact Form 7, saves all messages through contact forms into the database. Otherwise, you may lose important messages forever if your mail server has issues or you make a mistake in mail configuration. It keeps an email address book and a list of all messages with detailed information which you can look up in WordPress anytime.

MailPoet 3 Premium

The MailPoet 3 Premium plugin is the most popular email and newsletter solution for WordPress. With a free account, which we signed up for on your behalf, you can send 5,000 emails per month to up to 1,000 subscribers through MailPoet Sending Service for free. Their high-availability service sends +30 million emails each month with a 98.5% deliverability rate. We authenticated info@yourdomain.com as the sending address with MailPoet and configured the sender domain authentication to ensure email deliverability.

The sign-up form is at the bottom of each page above the footer:

When the user subscribes with a valid email address, the box informs about the confirmation email:

The sign-up confirmation often called "double opt-in", ensures your subscribers willingly joined your email list. All new subscribers will first receive a “confirmation email” from the MailPoet plugin. Inside this email, there is a link that must be clicked in order to activate the subscription to the newsletter. If they don’t click the link and confirm their subscription, they will remain “Unconfirmed” and will not receive any newsletters. The sign-up confirmation option is enforced when sending emails with MailPoet Sending Service, and there’s no option to disable it. See the checklist before importing an old email address list into Mailpoet.

When the user clicks on the "I confirm my subscription!" link from the confirmation email, he is directed to this webpage:

Further reading:

• MailPoet Knowledgebase
• Create a Standard Newsletter
• How to Be a Nice Sender

PublishPress Future

The PublishPress Future plugin allows you to add an expiration date to posts. pages and other content types. When your post is automatically unpublished, you can delete the post, change the status, or update the post categories.

Here’s an overview of what you can do with PublishPress Future:

• Choose expiry dates for content in any post type.
• Select expiry dates in the right sidebar when editing posts.
• Modify, remove or completely delete content when the expiry date arrives.
• Modify expiry dates using “Quick Edit” and “Bulk Edit”.
• Receive email notifications when your content expires.
• Show expiry dates in your content, automatically or with shortcodes.

Enable Post Expiration while editing a post or page.

Enable Post Expiration in the quick-edit menu.

Site Kit by Google

Site Kit is the official WordPress plugin from Google for insights about how people find and use your site. Site Kit is the one-stop solution to deploy, manage, and get insights from critical Google tools to make the site successful on the web. It provides authoritative, up-to-date insights from multiple Google products directly on the WordPress dashboard for easy access, all for free.

Bringing the best of Google tools to WordPress

Site Kit includes powerful features that make using these Google products seamless and flexible:

• Easy-to-understand stats directly on your WordPress dashboard
• Official stats from multiple Google tools, all in one dashboard
• Quick setup for multiple Google tools without having to edit the source code of your site
• Metrics for your entire site and for individual posts
• Easy-to-manage, granular permissions across WordPress and different Google products

Supported Google tools

Site Kit shows key metrics and insights from different Google products:

• Search Console: Understand how Google Search discovers and displays your pages in Google Search. Track how many people saw your site in Search results, and what query they used to search for your site.
• Analytics: Explore how users navigate your site and track goals you’ve set up for your users to complete.
• AdSense: Keep track of how much your site is earning you.
• PageSpeed Insights: See how your pages perform compared to other real-world sites. Improve performance with actionable tips from PageSpeed Insights.
• Tag Manager: Use Site Kit to easily set up Tag Manager- no code editing required. Then, manage your tags in Tag Manager.
• Optimize: Use Site Kit to easily set up Optimize- no code editing required. Then, set up A/B tests in Optimize.

Installation

We installed and configured the Site Kit for you as part of our services. It will collect the analytics data starting on day 1:

We’re Open!

Change Opening Hours and Add Exceptions

The video shows how to enter the hours for a business that's open Monday through Friday from 9 am to 5 pm. Then we add an exception for a day where the business opens at noon. Finally, we add Independence Day as a closure day.

Layout sample

Standard layout for opening hours

Theme Settings

We usually set the below defaults already when we create the website. But you can always modify the settings to use different images and keep the website fresh.

Go to General Theme Settings

Select the Post Types that will be used on this website. Turning off unused types helps declutter the screen.

Select the standard background color for alerts. The fallback is Danger. Follow the link to see the different colors as defined in your theme.

Define the number of days from today that will show as Special Rate on the booking calendar. A value of 0 turns this feature off.
Set the colors for the bookings calendar.

There are no options for the Contacts.

Set the default thumbnail image that precedes every Event on the website. Leave empty if you don't prefer any images on the Events.

Set the default thumbnail image that precedes every FAQ on the website. Leave empty if you don't prefer any images on the FAQs.

Set the default thumbnail image that precedes every Fundraiser on the website. Leave empty if you don't prefer any images on the Fundraisers.

Set the default thumbnail image that precedes every News on the website. Leave empty if you don't prefer any images on the News.

Set the default thumbnail images for female and male avatars that show next to the testimonial. Note: Leaving them empty will make the testimonials without their own image look odd.

Alerts

Alerts are one-line messages that show prominently at the beginning of the homepage. They can be used to notify visitors about important changes or ongoing specials. For example, temporary business hour variations or special rates are good fits.

Add alerts

The video shows how to enter a couple of dummy alerts and how to sort them in the post listing. The first entry is a straight alert using the standard background color. The second one sets a different background color. The title itself does not show anywhere, only the text field will be displayed. The order field helps sort the posts. You can leave it at the standard of 10 if you are not concerned about the order.

Expire Alerts

Alerts are usually only needed for a short period. A temporary business hour change doesn't have to be displayed anymore once the hours are back to normal. By setting an expiration date at the alert, it will automatically disappear when the defined day/time arrives.

Layout samples

Standard layout for alerts on homepage

Bookings

Enter Bookings

The video shows how to enter and quick-edit bookings. The first booking is for one day, while the second booking spans a full workweek. The list of bookings can then sort by the start date to see them in chronological order. The bookings expire in draft status the following month after the end date since they do not show anymore on the calendar. The quick-edit menu allows changing the status of the booking without having to open the full editor.

Layout samples

The custom posts for bookings can be displayed in several layouts.

Slider

Accordion

Contacts

Upload and Crop Images

The video demonstrates how to upload images and crop square thumbnails for the contact image. The image must be square and at least 150 by 150 pixels, or the circular cutout will look elliptical.

Enter Contacts

The video shows how to enter a new contact with the custom posts. All fields, except for the name, are optional. The category "Contacts" and a menu order gets assigned to display these contacts in a predetermined order.

Layout samples

The custom contacts posts can be displayed in several layouts. Below are four sample layouts: Card, vertical card, round image, and raised image.

Card

CEO

John Doe

CFO

Dave Moneypenny

COO

Samantha Cunningham

CIO

Thomas Avignon

VP

Jane Mulligan

General Manager

William Lee

Vertical Card

CEO

John Doe

CFO

Dave Moneypenny

COO

Samantha Cunningham

CIO

Thomas Avignon

VP

Jane Mulligan

General Manager

William Lee

Round Image

CEO

John Doe

CFO

Dave Moneypenny

COO

Samantha Cunningham

CIO

Thomas Avignon

VP

Jane Mulligan

General Manager

William Lee

Raised Image

John Doe

CEO

Dave Moneypenny

CFO

Samantha Cunningham

COO

Thomas Avignon

CIO

Jane Mulligan

VP

William Lee

General Manager

Events

The event posts can be used to create calendar events with a detailed description. The title is the event name. Each event has a mandatory start date field and an optional end date for longer events. The detailed text field allows shortcodes but no further formatting other than linebreaks. Each post can display a different thumbnail image to visually highlight the type of event. If none is provided, it will use the image from the general settings. A second, larger image can be shown to the right of the detailed description. In the final layout, all entries are ordered by the start date.

Add an event

The video shows how to enter a few dummy events. The first entry doesn't set any images. The second one picks a different thumbnail image. The third FAQ picks a different thumbnail image as well as the additional image for the text area. Finally, you see the list of entered events. Sorting by the start date column rearranges the posts in the order they will later show up.

Layout samples

The custom events posts can be displayed in several layouts. Below are four sample layouts: Slider, accordion, unordered list, and flat.

Generic Posts

The generic posts are very similar. Their title is either the headline (news and fundraiser) or the questions (FAQ). All have a text field for their detail or answer. The text field allows shortcodes but no further formatting other than linebreaks. Each post can have its thumbnail image. If none is provided, it will use the image from the general settings. The order field helps sort the posts. You can leave it at the standard of 10 if you are not concerned about the order.

Add a generic post

The video shows how to enter a few dummy FAQs and how to sort them in the post listing. The first entry is a straight text FAQ. The second one shows how to set a different image and use a link in the text. The third FAQ is saved as a draft and will not show up until its published. The fourth example defines an expiration date for the post that sets it to draft status on the expiration day/time. Finally, you see the list of entered posts. Sorting by the order column rearranges the posts in the order they will later show up.

Layout samples

The generic custom posts can be displayed in several layouts. Below are four sample layouts for each generic post type: Slider, accordion, unordered list, and flat.

FAQs:

Fundraiser:

News:

Testimonials

Upload and Crop Images

The video demonstrates how to upload images and crop square thumbnails for the tutorial image. The image must be square and at least 150 by 150 pixels, or the circular cutout will look elliptical.

Enter Testimonials

The video shows how to enter testimonials with the custom posts. The first two testimonials use the images we prepared in the previous step. The third testimonial will use a generic image. For that, we don't select an image but enter the gender instead. You also need to select the correct category if you have different testimonial posts on your webpage; this is not shown in the below video.

Layout samples

The custom posts for testimonials can be displayed in several layouts.

Slider (Image left on wider screens, otherwise on top)

Accordion

Displaying Custom Post Types

We use the Display Posts plugin to query and display our custom post types in WordPress. The plugin selects the posts by any combination of type, status, category, tag, meta key, or search query and sorts them by date, title, menu order, or meta value - to name just the most important ones. Open, close, and output filters allow full control over the output.

This shortcode displays all FAQs with the category 'general' ordered by the menu order in an accordion. The message "No FAQs at this time" is shown in case the selection has no results.

[display-posts post_type="faq" category="general" no_posts_message="No FAQs at this time" wrapper="accordion"]

General Display Posts Query and Display Parameters

The following parameters are common for all custom post types. In general, all parameters listed in the display-posts documentation can be used but our custom post types extend or override some of them. Only those differences are listed here.

post_type
Specify which post type to use. You can use a default one (post or page), or a custom post type you’ve created.
Default: post
Options include: alert, booking, contact, event, faq, fundraiser, news, testimonial
Example: [display-posts post_type="event"]

wrapper_id
Specify a unique ID to be used on the wrapper of this listing.
Default: empty
Note: The wrapper_id is ignored on accordion and carousel wrappers because the plugin must generate its own ID.
Example: [display-posts category="cars" wrapper_id="cars-listing"]

posts_per_page
How many posts to display.
Default: -1 (list all posts)
Example: [display-posts posts_per_page="5"]

order
Specify whether posts are ordered in descending order (DESC) or ascending order (ASC).
Default: ASC
Example: [display-posts order="DESC"]

orderby
Specify what the posts are ordered by.
Default: menu_order
Options include: date, modified, rand, comment_count, menu_order, ID, author, title, name, type, meta_value, meta_value_num, post__in
Example: [display-posts orderby="date"]

listing_class
Specify the class name used for each post.
Default: listing-item
Example: [display-posts include_content="true" listing_class="dps-listing-item"]

layout
Custom parameter to specify which template part layout should be used. See the template parts tutorial.
Default: empty
Example: [display-posts layout="dps-listing-item"]

interval
The amount of time to delay between automatically cycling to the next item for a carousel in milliseconds. If 0, the carousel will not automatically cycle.
Default: 5000
Example: [display-posts wrapper="carousel" interval="3000"]

arrow_color_class
Specify the class name used for the arrows and dots at a carousel. You can use "dark" or "light" depending on the background color.
Default: dark
Example: [display-posts arrow_color_class="light"]

left_arrow
Show the left arrow at a carousel.
Default: true
Example: [display-posts left_arrow="false"]

right_arrow
Show the right arrow at a carousel.
Default: true
Example: [display-posts right_arrow="false"]

carousel_width
The width of the carousel content in percent. The left and right arrows each use 15% and will be on top of the content if the percentage is greater than approximately 85%.
Default: 70
Example: [display-posts right_arrow="false" left_arrow="false" carousel_width="100"]

carousel_dots
Show the indicator dots below the slider.
Default: true
Example: [display-posts carousel_dots="false" right_arrow="false" left_arrow="false" carousel_width="100"]

transient_key
This should be a unique key you define to cache the output. Each key will be cached separately, so if you are using the same shortcode on multiple pages you can use the same key for each one (cache it once rather than separately). Internally, the name of the key is expanded with the word "dps", the post type, and a checksum of the parameters. Whenever a new post is created or an existing one is modified, all caches for this post type are deleted to ensure accurate data.
Default: none
Example: [display-posts transient_key="all_posts" transient_expiration="2 * DAY_IN_SECONDS"]

transient_expiration
This is how long (in seconds) the data should be cached. You can specify a number (ex: 86400), or use one of the time constants to make it easier to read (ex: WEEK_IN_SECONDS). You can also multiply the constants (ex: 2 * DAY_IN_SECONDS ).
Default: none
Example: [display-posts transient_key="all_posts" transient_expiration="WEEK_IN_SECONDS"]

Featured Image

The featured image in our custom posts should always have a square thumbnail image defined. Otherwise, the round images will look like ovals. Follow these steps to define a square thumbnail image:

• Media Manager
• Click on the image
• Click on "Edit Image" under the image
• Select "Thumbnail" under "Apply changes to:"
• Click on "Crop"
• Select the thumbnail area on the image
• Make the width and height under the Image Crop Selection the same
• Click on "Crop" again
• Click on "Save"

Display Parameters for Alerts

There are no additional display parameters for the custom post type Alert.

Display Parameters for Generic Post

wrapper
What type of HTML should be used to display the listings. It can be an unordered list (ul), ordered list (ol), divs (div), accordion, or carousel (slider).
Default: ul
Example: [display-posts wrapper="accordion"]

icon_class
Specify the class name used for the icon.
Default: icon
Example: [display-posts post_type="news" icon_class="my-icons"]

title_class
Specify the class name used for the title. The title content depends on the post type. It could be the questions at a FAQ, the headline at an Event, or the name at a Contact or Testimonial.
Default: title
Example: [display-posts post_type="news" icon_class="my-titles"]

image_class
Specify the class name used for the featured image.
Default: image
Example: [display-posts post_type="news" image_class="my-images"]

icon_max_height
Specify the maximum optional icon height in px.
Default: 50
Example: [display-posts post_type="news" icon_max_height="75"]

image_size
Specify an image size for displaying the featured image, if the post has one. The image_size can be set to thumbnail, medium, large (all controlled from Settings > Media), or a custom image size.
Default: medium
Example: [display-posts post_type="news" image_size="large"]

include_title
Include the post’s title. The title content depends on the post type. It could be the questions at a FAQ, the headline at an Event, or the name at a Contact or Testimonial.
Default: true
Example: [display-posts post_type="news" include_title="false"]

include_icon
Include the post’s icon if there is a default icon for the post type.
Default: true
Example: [display-posts post_type="news" include_icon="false"]

include_content
Specify whether or not to include the post content, usually the text field. Note that [display-posts] will be stripped out of the content to prevent infinite loops
Default: true
Example: [display-posts post_type="news" include_content="false"]

include_image
Specify whether or not to include the featured image, if the post has one.
Default: true
Example: [display-posts post_type="news" include_content="false"]

read_more
Specify whether or not to show only the content which comes before the <!--more--> tag at a carousel. The user has to click a "read more" button to see the full text.
Default: true
Example: [display-posts post_type="news" read_more="false"]

include_date
Specify whether or not to include the date at an event.
Default: true
Example: [display-posts post_type="news" include_date="false"]

date_class
Specify the class name used for the date at an event.
Default: date
Example: [display-posts post_type="news" date_class="my_dates"]

date_format
Specify the display date format used for the date at an event.
Default: m/d/Y
Example: [display-posts post_type="news" date_format="(m/d/Y)"]

time_format
Specify the display time format used for the time at an event.
Default: g:i a
Example: [display-posts post_type="news" time_format="H:i"]

Display Parameters for Testimonials

wrapper
What type of HTML should be used to display the listings. It can be an accordion or a carousel (slider).
Default: carousel
Example: [display-posts wrapper="accordion"]

size
Specify the size of the testimonials. Options are "large" for the image to the left of the text or "small" for the image on top of the text.
Default: large
Example: [display-posts post_type="testimonial" size="small"]

image_max_height
Specify the maximum height of the image in pixels.
Default: 150
Example: [display-posts post_type="testimonial" image_max_height="200"]

read_more
Specify whether or not to show only the content which comes before the <!--more--> tag at a carousel. The user has to click a "read more" button to see the full text.
Default: true
Example: [display-posts post_type="testimonial" read_more="false"]

title_class
Specify the class name used for the name.
Default: title
Example: [display-posts posts_type="testimonial" title_class="my-titles"]

job_title_class
Specify the class name used for the job title(s).
Default: job-title
Example: [display-posts posts_type="testimonial" job-title_class="my-job-titles"]

image_class
Specify the class name used for the image.
Default: image
Example: [display-posts post_type="testimonial" image_class="my-images"]

text_class
Specify the class name used for the testimonial text.
Default: text
Example: [display-posts post_type="testimonial" text_class="my-text"]

include_title
Include the name.
Default: true
Example: [display-posts post_type="testimonial" include_title="false"]

include_job_title
Include the job title(s).
Default: true
Example: [display-posts post_type="testimonial" include_job_title="false"]

include_stars
Include the star rating.
Default: true
Example: [display-posts post_type="testimonial" include_stars="false"]

include_image
Include the featured image.
Default: true
Example: [display-posts post_type="testimonial" include_image="false"]

Display Parameters for Bookings

wrapper
What type of HTML should be used to display the listings. It can be an "accordion" or a "carousel" (slider).
Default: accordion
Example: [display-posts post_type="bookings" wrapper="carousel"]

title_class
Specify the class name used for the month and year title at the accordion.
Default: title
Example: [display-posts posts_type="booking" title_class="my-titles"]

legend_class
Specify the class name used for the legend under the calendar.
Default: legend
Example: [display-posts posts_type="booking" legend_class="my-legends"]

calendar_class
Specify the class name used for the calendar.
Default: calendar-table
Example: [display-posts posts_type="booking" legend_class="my-calendars"]

calendar_item_class
Specify the class name used for the calendar days.
Default: calendar-table-item
Example: [display-posts posts_type="booking" legend_class="my-calendar-items"]

include_legend
Include the legend under the calendar.
Default: true
Example: [display-posts post_type="testimonial" include_legend="false"]

Display Parameters for Contacts

wrapper
What type of HTML should be used to display the listings. It can be a card, a vertical card (vertical-card), a round-image (round-image), or a raised image (raised-image).
Default: card
Example: [display-posts post_type="contact" wrapper="accordion"]

image_max_height
Specify the maximum height of the image in pixels for wrappers "round-image" and "raised-image".
Default: 150
Example: [display-posts post_type="contact" image_max_height="200" image_max_width="200"]

image_max_width
Specify the maximum width of the image in pixels for wrappers "round-image" and "raised-image".
Default: 150
Example: [display-posts post_type="contact" image_max_height="200" image_max_width="200"]

max_width
Specify the maximum width in pixels of the cards for wrappers "card" and "vertical-card". Both use an image of size "medium" which is usually 300 pixels wide.
Default: 300 for "card" and 540 for "vertical-card"
Example: [display-posts post_type="contact" wrapper="vertical-card" max_width="600"]

name_class
Specify the class name used for the name.
Default: name
Example: [display-posts post_type="contact" wrapper="card" name_class="my-names"]

position_class
Specify the class name used for the job position.
Default: position
Example: [display-posts post_type="contact" wrapper="card" position_class="my-positions"]

image_class
Specify the class name used for the image.
Default: image
Example: [display-posts post_type="contact" wrapper="card" image_class="my-images"]

text_class
Specify the class name used for the text.
Default: text
Example: [display-posts post_type="contact" wrapper="card" text_class="my-text"]

social_listing_class
Specify the class name used for the social listing.
Default: social_list
Example: [display-posts post_type="contact" wrapper="card" social_listing_class="my-social-list"]

social_item_class
Specify the class name used for the social items.
Default: social-item social
Example: [display-posts post_type="contact" wrapper="card" social_item_class="my-social-item"]

email_class
Specify the class name used for the social email item.
Default: social-item email
Example: [display-posts post_type="contact" wrapper="card" email_class="my-social-email-item"]

phone_class
Specify the class name used for the social phone item.
Default: social-item phone
Example: [display-posts post_type="contact" wrapper="card" phone_class="my-social-phone-item"]

include_name
Include the name.
Default: true
Example: [display-posts post_type="contact" wrapper="vertical=card" include_name="false"]

include_position
Include the position.
Default: true
Example: [display-posts post_type="contact" wrapper="vertical=card" include_position="false"]

include_text
Include the text.
Default: true
Example: [display-posts post_type="contact" wrapper="vertical=card" include_text="false"]

include_image
Include the image.
Default: true
Example: [display-posts post_type="contact" wrapper="vertical=card" include_image="false"]

include_email
Include the email.
Default: true
Example: [display-posts post_type="contact" wrapper="vertical=card" include_email="false"]

include_phone
Include the phone.
Default: true
Example: [display-posts post_type="contact" wrapper="vertical=card" include_phone="false"]

include_social
Include the social and business accounts.
Default: true
Example: [display-posts post_type="contact" wrapper="vertical=card" include_social="false"]

Custom Posts Field Names

The title (the_title()) depends on the post type:

• Alert => not used
• Booking => not used
• Contact => Name
• Event => Short Description
• FAQ => Question
• Fundraiser => Short Description
• News => Short Description
• Testimonial => Name

Alerts

• text (type wysiwyg)
• color (type select)

Booking

• start_date (type date_picker)
• end_date (type date_picker)
• status (type radio)
• comment (type wysiwyg)

Contacts

• position (type text)
• email (type email)
• phone (type text)
• text (type wysiwyg)
• twitter_url (type url)
• facebook_url (type url)
• instagram_url (type url)

Event

• image (type image)
• start_date (type date_time_picker)
• end_date (type date_time_picker)
• text (type wysiwyg)
• image_position (type radio)

FAQ

• text (type wysiwyg)
• image (type image)
• image_position (type radio)

Fundraiser

• text (type wysiwyg)
• image (type image)
• image_position (type radio)

News

• text (type wysiwyg)
• image (type image)
• image_position (type radio)

Testimonial

• picture (type image)
• gender (type radio)
• title (type wysiwyg)
• stars (type number)
• text (type wysiwyg)

Image Slider

Adding images to the slider

The video shows how to add images to the slider. We set up your main image slider to show all images with the category "Slider". You need to use the appropriate category should your webpage contain multiple sliders.

Remove image from the slider

The video shows how to remove an image from the slider. It's done by unchecking the "Slider" category in the image. You need to use the appropriate category should your webpage contain multiple sliders.

Sample slider

This image slider is generated with help of the plugins "Media Library Assistant" and "Photonic Gallery & Lightbox". It pulls all images with a certain category into the slider.