### HappenStance 1.0 Documentation by Tomas Toman

# HappenStance

Created: 01/12/2014
By: Tomas Toman
Web: www.tomastoman.cz

First of all, I would like to thank you for choosing HappenStance! I firmly believe that you will be satisfied with this theme. In case of any problems or doubts, you can use the HappenStance Official Support (in English, German or Czech).
Thanks so much!

## Navigation

1. About HappenStance
2. Theme installation
   1. Update to Premium Version
3. Theme options
   1. General settings
   2. Header settings
   3. Posts/Pages settings
   4. Post Entries settings
   5. Colors settings (only in Premium Version available)
   6. Fonts settings
   7. Social networking (only in Premium Version available)
   8. Other settings
4. Background and Header settings
   1. Main Background settings
   2. Header Image settings
   3. Homepage Header Slideshow (only in Premium Version available)
   4. Pages/Posts Header Slideshow (only in Premium Version available)
5. Widget areas
   1. Right Sidebar
   2. Footer widget areas
   3. Footer notices
   4. Homepage slideshow (only in Premium Version available)
6. Custom widgets (only in Premium Version available)
   1. HappenStance Posts Widgets
   2. HappenStance Facebook Like Box Widget
   3. HappenStance Twitter Widget
   4. HappenStance Info-Box Widget
   5. HappenStance Tab Widget
7. Menu areas
   1. Main Header Menu
   2. Social Networks Links (only in Premium Version available)
   3. Carousel Menu (only in Premium Version available)
8. Page templates
   1. Sitemap (only in Premium Version available)
   2. Full Width
   3. Full Width without Share Buttons (only in Premium Version available)
   4. Page without Share Buttons (only in Premium Version available)
   5. Page without Title
   6. Landing Page
9. Post Formats
10. Drag-and-drop Page Builder (only in Premium Version available)
11. Custom Sidebars managing (only in Premium Version available)
12. Plugins
    1. Breadcrumb Navigation plugin
    2. Events Calendar plugin
13. Custom Shortcodes (only in Premium Version available)
14. Translations
15. FAQs about WordPress

### A) About HappenStance - top

HappenStance is an easily customizable theme which can be used for your Blog, Magazine, Business, eCommerce or Events website. It is a fully responsive and Retina ready theme that allows for easy viewing on any device. Using the Theme Options panel, you can customize this theme directly to your needs. HappenStance is fully compatible with the popular plugins WooCommerce and The Events Calendar.

#### HappenStance Free Version features

- HTML5/CSS3 support
- Responsive design
- Retina ready
- Intuitive Theme Options panel
- WooCommerce 2.1+ ready
- The Events Calendar 3.8+ ready
- 4 pre-defined color schemes (Blue, Gray, Green, Purple)
- Selection from 220 Google fonts for all the key headlines and text passages
- Selection between Boxed or Wide layout
- Selection between one- or two-columns layout (with or without the Right Sidebar)
- Header Menu Area with unlimited levels of drop-down submenus
- Contact Information box in header (address, email, phone, Skype)
- Select between displaying Logo/Site Title in header
- Custom Header Image
- Breadcrumb navigation
- Scroll-top button
- Sidebar and Footer widget areas
- Selection between 2 Blog Layouts (One Column or Grid - Masonry)
- Full Width, Landing Page and Page Without Title custom page templates
- Easily add your own Favicon
- Easily add custom CSS
- Post Formats support (Aside, Audio, Image, Standard, Status, Video)
- Ready for translation into your language (.pot file integrated)
- Integrated Czech, French, German, Russian, Slovak and Spanish language localizations
- RTL languages supported

#### HappenStance Premium Version additional features

- Integrated support for Drag-and-drop Page Builder with 37 default widgets for creating custom page layouts
- 8 pre-defined color schemes (Blue, Gray, Green, Orange, Pink, Purple, Red and Turquoise)
- Unlimited ability to set custom color scheme (color settings)
- Font Size settings
- Header Carousel box (slider with your Latest Posts, Latest Events or with a Custom Menu)
- Social Network Profile links in header
- Ability to set different Header Images for the individual pages/posts/categories
- Image Slideshow with 3 different templates
- Ability to set different Header Slideshows for the individual pages/posts
- Homepage Header Slideshow widget area
- Ability to set different Sidebars/Footers for the individual pages/posts
- 4 dynamic Hover effects for the Post Thumbnails (Fade, Focus, Shadow and Tilt)
- 6 Custom widgets for displaying the latest posts from the specific categories (as a Column, Grid, List, Slider, Thumbnails or by Default - One Column)
- Custom Tab Widget (displays popular posts, recent posts, comments and tags in tabbed format)
- Info-Box Custom widget (displays a text box with an icon)
- Facebook Like Box Custom widget
- Twitter Following Custom widget
- Integrated Facebook/Twitter/Google+1 share buttons
- Integrated automatic Sitemap generator with advanced options
- Sitemap, Full Width, Landing Page, Page Without Title and 2 Without Share Buttons custom page templates
- Related Posts box
- Custom Shortcodes for displaying buttons, tables, highlighted texts, slideshows and images anywhere you like
- Custom Shortcodes for displaying specific listing of posts anywhere you like
- Custom Shortcode for displaying Google maps
- Easily add custom JavaScript

Compatible Browsers: Internet Explorer 8+, Google Chrome, Mozilla Firefox, Opera, Safari
Compatible WordPress Versions: 3.8+

### B) Theme installation - top

For HappenStance installation, you must follow these basic steps:

1. Extract the folder "happenstance.zip".
2. Using a FTP client (for example Total Commander), upload the extracted folder "happenstance" to "wp-content/themes" directory on your web host server.
3. Log in to your WordPress administration.
4. Select the "Appearance > Themes" panel.
5. Click on the "Activate" link at the HappenStance theme.

Alternatively, you can install this theme via your WordPress administration. Go to "Appearance > Themes" panel and using "Add New" tool upload the original ZIP file. After uploading, activate the theme.

#### 1. Update to Premium Version

Once you have purchased the HappenStance Premium Version, simply upload the extracted folder that you have got by purchasing HappenStance Premium Version via FTP to "wp-content/themes" directory on your web host server.

Alternatively, you can install the Premium Version via your WordPress administration:

1. Go to "Appearance > Themes" panel.
2. Click on the "Add New" link.
3. Now, click on the button "Upload Theme" just beside the headline "Add Themes".
4. Upload here the ZIP folder "happenstance-premium.zip" which you have downloaded from your Purchase Receipt.
5. Now, you will be able to activate the HappenStance Premium theme.

### C) Theme options - top

The options framework is accessible through the panel "Appearance > Theme Options".

#### 1. General settings

This tab is used for choosing one of the basic color schemes and setting some parts of your website (layout style, background pattern, right sidebar and breadcrumb navigation displaying, favicon).

#### 2. Header settings

If you want to display your custom Logo at the place of the Site Title, simply upload or choose your logo image in "Theme Options > Header > Logo URL". For removing the Logo and setting the Site Title again, just delete the URL address of your Logo in "Theme Options > Header > Logo URL".

In the "Carousel Box Settings" section, you can find the options for setting the Carousel Box which can display an infinite slider with your latest posts, latest events or a custom menu (which you have previously created and assigned to the "Carousel Menu" location in "Appearance > Menus" panel). (only in Premium Version available)

In the "Contact Information" section, you can fill out your address, email, phone number and Skype name to be displayed above the Site Title/Logo.

#### 3. Posts/Pages settings

Under this tab, you can set displaying of the related posts, featured images and meta data on the individual single posts. You also can disable here displaying of the featured images on the static pages.

#### 4. Post Entries settings

Under this tab, you can set displaying of the Post Entries in your Blog and on the Archive/Search results pages. There are 2 different layouts for the Post Entries in HappenStance theme:

1. One Column (Post Entries are displayed one after another in one column)
2. Grid - Masonry (each Post Entry is dynamically positioned in the next open spot in the grid)

In the Premium Version, you can set here the number of columns for the Masonry Grid (2, 3 or 4) and a Hover effect for the Featured Images (Fade, Focus, Shadow, Tilt or None).

You also can set here if you would like to display the full Content or only the Excerpts within the Post Entries. Using the option "Excerpt Length", you can define the number of words you wish to display in the excerpt (the default value is 40 words).

#### 5. Colors (only in Premium Version available)

This tab is used for setting your own color scheme. You can choose here the colors of individual parts of layout, headlines and texts. Using color pickers, you can easily choose exactly that color you want. You also can directly enter the hexadecimal code of your favorite color.

Tip: If you want to use the same color for more items, simply copy and paste its hexadecimal code instead of setting it using color pickers on each item.

Color settings panel

#### 6. Fonts

This tab is used for selecting Google fonts for the individual headlines and text areas. HappenStance theme offers more than 200 fonts for choosing. The default fonts are specified in the main stylesheet file (style.css in the main theme folder). The default font used for headlines is "Oswald". Here you can preview all the available fonts: Google Fonts.
In the Premium Version, you also can set the font-size for all key headlines and text areas.

#### 7. Social networking (only in Premium Version available)

On this tab, you can choose wheter to display or not the Facebook, Twitter and Google+1 share buttons, which may appear below your single posts/pages content and on the individual events and WooCommerce products. You also can set here a language of the Share buttons.

Social networks sharing panel

#### 8. Other settings

On this tab, you can fill your own cascading style sheet information (CSS) for modifying the layout. So you do not need to create a child theme in this case. The CSS information defined on this tab appears in the "head" section of the source code.

Above the Custom CSS field, there are links for editing widgets, header image, main background and menus.

### D) Background and Header settings - top

#### 1. Main Background settings

For setting your own main background image or color, please go to "Appearance > Background" panel. Upload your own photography and set here all the background-image settings (position, repeating, attachment). For setting one-color background, use the color picker at the bottom of this page. To make the selected color visible, there should not be set any background image.

Note: If you are using the Boxed layout and would like to hide the main background pattern (hatches), you can do so in "Theme Options > General Settings > Background Pattern". You also can set here the opacity of the background pattern.

#### 2. Header Image settings

For setting your custom header image, please go to "Appearance > Header" panel and upload or select your own image. For properly displaying on wide-screen monitors in the Wide layout, the width of your header image should be about 2000 pixels. The recommended width for the Boxed layout is 1170 pixels. If the header image width is smaller than the page container width, the image will be displayed in the middle of the browser window with gray margins on both sides.

In "Theme Options > Header > Display Header Image", you can set the header image to be visible on all pages or only on the homepage.

#### 3. Homepage Header Slideshow (only in Premium Version available)

For making this feature available, the bundled Cyclone Slider 2 plugin has to be installed. For creating a new Slideshow, go to the "Cyclone Slider" panel in your WordPress administration. After creating a slideshow, go to the Widgets settings. The widget area for displaying Homepage slideshow is reserved for one "Cyclone Slider Widget". Its name in "Appearance > Widgets" panel is "Homepage slideshow". Put here one "Cyclone Slider Widget" and choose the slideshow you want to display on your homepage. After doing it, your slideshow will automatically replace the header image on your homepage.

#### 4. Pages/Posts Header Slideshow (only in Premium Version available)

For making this feature available, the bundled Cyclone Slider 2 plugin has to be installed. To set a Header Slideshow for any page or post, just insert the appropriate Slideshow ID into the field "Header Slideshow", located under the Visual Editor (when you create/edit a page or post). The Slideshow will automatically replace the Header Image.
You can find the Slideshow ID in the "Cyclone Slider > Cyclone Slider" panel - in the list of all published slideshows, there is a column called "Slideshow ID".

### E) Widget areas - top

There are several areas for displaying widgets in HappenStance theme:

1. Right Sidebar widget area
2. Footer widget areas (Left, Middle and Right)
3. Footer notices
4. Homepage slideshow (only in Premium Version available)

The Widget panel is located in "Appearance > Widgets" panel. If you want to place a widget into a widget area, simply drag its panel and drop it to the area where you want to display the widget.

HappenStance Premium theme also allows you to create custom Right Sidebars and Footers which can replace the default widget areas on the individual pages/posts. See this paragraph for more information.

#### 1. Right Sidebar widget area

Right Sidebar widget area is displayed on all your pages and posts. Its name in "Appearance > Widgets" panel is "Right Sidebar". You can put here as many widgets as you like.
If you do not want to display the Right Sidebar on all your pages/posts, you can hide it in "Theme Options > General Settings > Display Sidebar on Posts/Pages".
If you do not want to display the Right Sidebar on your archive pages (including all archives, blog page and search results), you can hide it in "Theme Options > General Settings > Display Sidebar on Archives".

#### 2. Footer widget areas

Footer widget area is displayed in the footer as the 3 columns of widgets. In "Appearance > Widgets" panel, you can see 3 areas for the individual columns: "Footer left widget area", "Footer middle widget area" and "Footer right widget area". These areas represent the 3 columns of widgets in footer. You can put as many widgets as you want into each column.

#### 3. Footer notices

The widget area for copyright and other notices is displayed in the footer, below the main Footer widget area (described above). Its name in "Appearance > Widgets" panel is "Footer notices". Put here one "Text" widget. Into the content field of this widget fill the text (or HTML code) you want to display here. The "Title" field of this Text widget should stay empty.
Note: To display the Footer notices in the middle of the box, check the option "Automatically add paragraphs" at the Text widget inserted into this area.

#### 4. Homepage slideshow (only in Premium Version available)

The widget area for displaying Homepage slideshow is reserved for one "Cyclone Slider Widget". Its name in "Appearance > Widgets" panel is "Homepage slideshow". Put here one "Cyclone Slider Widget" and choose the slideshow that you want to display on your homepage.

For making this feature available, the Cyclone Slider 2 plugin has to be installed. For creating a new Slideshow, go to the "Cyclone Slider" panel in your WordPress administration. After creating the Slideshow, go to the Widgets settings and follow the steps described above.

### F) Custom widgets (only in Premium Version available) - top

HappenStance Premium theme offers 10 custom widgets altogether:

1. 6 HappenStance Posts Widgets
2. HappenStance Facebook Like Box Widget
3. HappenStance Twitter Widget
4. HappenStance Info-Box Widget
5. HappenStance Tab Widget

#### 1. HappenStance Posts Widgets (only in Premium Version available)

HappenStance Posts Widgets allow to display the latest posts from the specific categories on any page using the bundled Page Builder. You can choose from 6 different HappenStance Posts Widgets:

1. HappenStance Posts-Column (displays the latest posts from the selected category as a column with highlighted first post)
2. HappenStance Posts-Default (displays the latest posts from the selected category in the standard way - one after another in one column)
3. HappenStance Posts-Grid (displays the latest posts from the selected category as a Masonry grid)
4. HappenStance Posts-List (displays the latest posts from the selected category as an unordered list with highlighted first post)
5. HappenStance Posts-Slider (displays the latest posts from the selected category as a horizontal slider)
6. HappenStance Posts-Thumbnail (displays the latest posts from the selected category as the thumbnails of featured images)

Note: HappenStance Posts Widgets are designed ONLY for working with the Page Builder. They can not be displayed in the Right Sidebar or in the Footer widget areas.

#### 2. HappenStance Facebook Like Box Widget (only in Premium Version available)

This widget is ready to use for displaying the Facebook Like Box. The Like Box is a special version of the Like Button designed only for Facebook Pages. Using this widget, you can easily promote your Facebook page on your website.
Put HappenStance Facebook Like Box Widget into the Sidebar or Footer widget area in "Appearance > Widgets" panel and fill the full URL of your Facebook Page that will be liked. Then set a height of Like Box and specify whether to display the profile photos of people who like the Page and a stream of the latest posts by the Page.

#### 3. HappenStance Twitter Widget (only in Premium Version available)

This widget is ready to use for displaying the Twitter Follow button. Put HappenStance Twitter Widget into the Sidebar or Footer widget area in "Appearance > Widgets" panel and fill the Twitter username you want to display via Twitter Follow button.

#### 4. HappenStance Info-Box Widget (only in Premium Version available)

This widget is ready for displaying a text box with a header icon. You can insert this widget into the Right Sidebar or into the content of a static page using the Page Builder.
To display an icon above the headline, just insert the class name of the desired icon into the "Icon:" field (for example: arrow_up). Here is the list of all supported icons and their class names:

#### 5. HappenStance Tab Widget (only in Premium Version available)

This widget is ready for displaying the popular posts, recent posts, comments and tags in tabbed format in your sidebar.

### G) Menu areas - top

In HappenStance theme, there are 3 menu areas (only 1 in the Free version):

1. Main Header Menu
2. Social Networks Links (only in Premium Version available)
3. Carousel Menu (only in Premium Version available)

#### 1. Main Header Menu

At first, create a new menu in "Appearance > Menus" panel and assign it to the "Main Header Menu" location. Then, in the left panels choose the requested pages/categories or custom links and add them to your new Menu. Then save all changes.

If you would like to create a drop-down submenu, just drag the required menu item and move it more to the right against its parent item. When you drop your sub-item, it should stay with indentation against the parent item. This way you can create unlimited levels of submenus.

#### 2. Social Networks Links (only in Premium Version available)

This menu location is designed for managing your social networks profile links, which will be displayed as icons in the header section. Here is a guide how to set this menu:

1. Create a new menu in "Appearance > Menus" panel and assign it to the "Social Networks Links" location.
2. Using the "Links" box on the left, insert as many social networks profile links as you like into the menu.
3. Into the "URL" field of each link, insert an URL address of some social network profile/page (for example: http://www.facebook.com/myprofile).
4. Into the "Link Text" field of each link, insert a class name of the appropriate icon (for example: social_facebook). Here is the list of all supported icons with their class names:

As the "Link Text" field for the Social Networks Links menu is designed only for inserting class names of icons, all other texts filled here will not be displayed.

Social Networks Links menu settings

#### 3. Carousel Menu (only in Premium Version available)

This menu location is designed for displaying an infinite slider containing a custom navigation links in the header. Once you assign a menu to the Carousel Menu location, you need to go into "Theme Options > Header > Carousel Content" and set here the value "Carousel Menu", because the Carousel Box by default displays your latest posts.
Note: The Carousel Menu is not designed for displaying any submenus.

### H) Page templates - top

Beside Default Template, HappenStance offers 6 other custom Page templates (only 3 in the Free version). If you create a new page or edit some existing page, you can choose the Page template in "Page Attributes > Template" right panel.

#### 1. Sitemap (only in Premium Version available)

"Sitemap" Page template is ready for displaying your sitemap page. If you want to use it, the bundled Dagon Design Sitemap Generator plugin has to be activated. The sitemap options can be specified in "Settings > DDSitemapGen" panel.

#### 2. Full Width

If you want to display only some pages without the right sidebar, simply use this template for these pages.

#### 3. Full Width without Share Buttons (only in Premium Version available)

This template displays the page in the same way as the "Full-width" template, but it will not display the Facebook, Twitter and Google+1 share buttons. It could be useful for creating pages using the Drag-and-drop Page Builder.

#### 4. Page without Share Buttons (only in Premium Version available)

This template displays the page in the same way as the "Default" template, but it will not display the Facebook, Twitter and Google+1 share buttons. It could be useful for creating pages using the Drag-and-drop Page Builder.

#### 5. Page without Title

This template displays only the page Content without the page Title.

#### 6. Landing Page

This template displays only the page content without the menus, right sidebar, comments area and the footer widget areas. You can use it for creating a temporary home page before your website will be ready for the public launch.

### I) Post Formats - top

You can choose a Post Format from a radio-button list when you create/edit a post. Beside the Standard posts, the following Post Formats are supported in HappenStance theme:

1. Aside
2. Audio
3. Image
4. Status
5. Video

### J) Drag-and-drop Page Builder (only in Premium Version available) - top

Using Drag-and-drop Page Builder, you can simply create your own page layouts. Working with Page Builder is as easy as managing widgets in "Appearance > Widgets" panel. By default (if all the HappenStance bundled features are active), the Page Builder contains 37 widgets altogether:

- 10 HappenStance custom widgets
- 12 default WordPress widgets
- 12 widgets bundled into the Page Builder plugin
- 1 Cyclone Slider widget
- 1 Breadcrumb Navigation widget
- 1 Events List widget

If you have installed some plugins offering their own custom widgets, they will be probably also included into the Page Builder widgets offer.

#### Here is a guide how to create a custom page layout:

1. Create a new page in "Pages > Add New" panel.
2. Page Builder adds an extra tab called "Page Builder" to the standard WordPress editor - click on this tab for displaying the Page Builder interface (it is located beside the standard "Visual" and "Text" tabs).
3. You will see the left toolbar with 3 icons: Add Widget, Add Row and Prebuilt Layouts.
4. The rows de facto represent individual widget areas. If you are creating a new row, you can specify the number of columns (widget areas) in this row. In the upper right corner of each row, you will see 3 icons. Clicking on the middle icon called "Visual Style", select the option "HappenStance" for widgets-layout pre-defined in this theme. If you select the "Default" visual style, the widgets will be displayed by the default way, which might not always fit into the page layout.
5. Click on the add widget button (plus icon) in the toolbar to bring up the widget selection interface. Click on the widget that you want to add to the selected column.
6. Now you can see the selected widget interface. Fill out the offered fields and then click on "Done" for saving the widget.
7. For editing the content of a widget, click on the title. If you want to move the widget to another column, just pick it up and drag it to the another column.
8. Publish or update the page.

Page-layout created by the Drag-and-drop Page Builder

Tip: If you do not want to display the Share Buttons on some page, just select the "Page without Share Buttons" or "Full Width without Share Buttons" page template instead of the Default Template.

### K) Custom Sidebars managing (only in Premium Version available) - top

If you would like to display different Right Sidebars or Footers on some specific pages, the bundled "Custom Sidebars Manager" plugin has to be installed. It gives you unlimited ability to replace the default Right Sidebar and Footer widget areas on every page/post by different widget areas.

1. Go to "Appearance > Install Plugins" and install the bundled "Custom Sidebars Manager" plugin.
2. Go to "Appearance > Widgets" and click on the button "Create a new sidebar" in the upper right corner.
3. Fill out the name and description of your custom sidebar.
4. Insert as many widgets as you like into the new sidebar.
5. Now, if you are editing some page/post, in right you can see a new box called "Sidebars". Simply select the desired sidebar for the "Right Sidebar" or "Footer" widget area from a drop-down list. The selected sidebar will replace the default widget area on that page.

If you go into "Appearance > Custom sidebars", under the tab "Default Sidebars" you will be able to set your custom sidebars according to the post type and category (for example, you can set different sidebars for all posts and for all pages).

### L) Plugins - top

Some functions of HappenStance theme are conditioned by installing some plugins.

List of recommended plugins for the Free version:

1. Breadcrumb NavXT
2. The Events Calendar

#### 1. Breadcrumb Navigation plugin

If you want to display the breadcrumb navigation just below the main content headlines, the Breadcrumb NavXT plugin has to be installed and activated. This plugin provides many advanced options for displaying breadcrumb navigation. You can set them in "Settings > Breadcrumb NavXT" panel.
Tip: If your Breadcrumb Navigation is too long, so it takes 2 or more lines, you can short the Title Length in "Settings > Breadcrumb NavXT > General" panel.

#### 2. Events Calendar plugin

This plugin allows you to create and manage events.

### M) Custom Shortcodes (only in Premium Version available) - top

HappenStance Premium theme offers several custom shortcodes for easy displaying some objects on pages/posts or in Text widgets:

1.) [image src="Image URL"]
Shortcode for displaying images. It is especially useful for inserting images into Text widgets.

2.) [table cols="headline1,headline2" data="row 1 value 1,row 1 value 2,row 2 value 1,row 2 value 2"]
Shortcode for displaying tables. The parameter "cols" is used for inserting headlines of individual columns. The parameter "data" is used for inserting own data in rows of your table.

3.) [button link="URL address"]TEXT OF YOUR BUTTON[/button]
Shortcode for displaying left-aligned buttons.

4.) [highlight]HIGHLIGHTED TEXT[/highlight]
Shortcode for displaying color-highlighted text (the color is editable in "Theme Options > Colors").

5.) [google-map address="Address of any place in the world" width="100%" height="200px"]
Shortcode for displaying Google maps. The "width" and "height" parameters are optional. You can set the dimensions in percentages or pixels, but for responzive displaying is recommended to input percentage dimensions.

6.) <!-- ddsitemapgen -->
Shortcode for displaying Sitemap in the content of any page/post.

7.) [cycloneslider id="slideshow-id"]
Shortcode for displaying a Slideshow in the content of any page/post. The appropriate shortcode for each Slideshow is automatically generated in "Cyclone Slider" panel.

8.) [display-posts category="category-slug" include_excerpt="true"]
Shortcode for displaying a listing of posts in post/page content or in a Text widget.
Arguments for [display-posts] shortcode:
author
Specify the post author
Default: empty
Example: [display-posts author="bill"]
category
Specify the category slug (or comma separated list of category slugs)
Default: empty
Example: [display-posts category="fishing,hiking"]
date_format
Specify the date format used when include_date is true. See Formatting Date and Time on the Codex for more information.
Default: '(n/j/Y)'
Example: [display-posts include_date="true" date_format="F j, Y"]
id
Specify a specific post ID (or multiple post IDs) to display.
Default: empty
Example: [display-posts id="9, 10"]
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 > Reading), or a custom image size.
Default: empty
Example: [display-posts image_size="thumbnail"]
include_date
Include the post's date after the post title. The default format is (7/30/12), but this can be customized using the 'date_format' parameter.
Default: empty
Example [display-posts include_date="true"]
include_excerpt
Include the post's excerpt after the title (and date if provided).
Default: empty
Example: [display-posts include_excerpt="true"]
offset
The number of posts to pass over
Default: 0
Example: [display-posts offset="3"]
order
Specify whether posts are ordered in descending order (DESC) or ascending order (ASC).
Default: DESC
Example: [display-posts order="ASC"]
orderby
Specify what the posts are ordered by. See the available parameters here.
Default: date
Example: [display-posts orderby="title"]
post_parent
Display the pages that are a child of a certain page. You can either specify an ID or 'current', which displays the children of the current page.
Default: empty
Example: [display-posts post_type="page" post_parent="8"]
post_status
Show posts associated with a certain post status
Default: publish
Example: [display-posts post_status="publish, future"]
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
Example: [display-posts post_type="event"]
posts_per_page
How many posts to display.
Default: 10
Example: [display-posts posts_per_page="5"]
tag
Display posts from a specific tag, or tags
Default: empty
Example: [display-posts tag="tag1, tag2"]
taxonomy, tax_term, and tax_operator
Use these parameters to do advanced taxonomy queries. Use 'taxonomy' for the taxonomy you'd like to query, 'tax_term' for the term slug (or terms) you'd like to include, and 'operator' to change how the query uses those terms (most likely this field will not be needed).
Default: 'taxonomy' = empty , 'tax_term' = empty , 'tax_operator' = 'IN'
Example: [display-posts taxonomy="color" tax_term="blue, green"]
wrapper
What type of HTML should be used to display the listings. It can be an unordered list (ul), ordered list (ol), or divs (div) which you can then style yourself.
Default: ul
Example: [display-posts wrapper="ol"]

### N) Translations - top

HappenStance theme is ready for translation into any language. The .pot file (happenstance.pot) is located in "languages" theme folder. HappenStance contains integrated Czech (cs_CZ), French (fr_FR), German (de_DE), Russian (ru_RU), Slovak (sk_SK) and Spanish (es_ES) language localizations. The best way how to make the language localization is by creating your own .po and .mo files and adding them into the "languages" theme folder. If you create them, please let me know, I will add your language localization into the official theme distribution.

If you don't know how to create the .po and .mo files, never mind! Simply install the CodeStyling Localization plugin and create your language localization in "Tools > Localization" panel.

### O) FAQs about WordPress - top

1.) Where could I edit my website title and description?

Go to the "Settings > General" panel and rewrite here the fields "Site Title" and "Tagline".

2.) Where could I allow/disallow comments adding?

Go to the "Settings > Discussion" panel and set the options according to your needs. If you want to disallow adding comments only for one specific page/post, you can do so using the "Quick Edit" link at this page/post in "Posts > All Posts" or "Pages > All Pages".

3.) What are the "Tags"?

Tags are similar to Categories. They are used for better description of posts. We can say that Tags are the keywords which specify the posts in great detail.

4.) How could I set title, description and keywords meta tags for each page and post?

The easiest way is to install some SEO plugin, for example All In One SEO Pack.

5.) Where could I set the number of posts, which display on index/categories/archives/search pages?

Go to the "Settings > Reading" panel and set the options according to your needs.

6.) I do not want to display the latest posts on my home page. Could I set a static page as my home page?

Yes, go to the "Settings > Reading" panel and choose the option "A static page" instead of "Your latest posts".

7.) How could I set the URL addresses of my pages and posts into user-friendly form, instead of "?p=123" displaying?

Go to the "Settings > Permalinks" panel and choose the option "Post name" in section "Common Settings".

8.) Where could I set my time zone and date/time format?

Go to the "Settings > General" panel and set the options according to your needs.

9.) Where could I set the header image?

Go to the "Appearance > Header" panel and upload here your own header image or select one of the already uploaded images.

10.) I have tried to upload a theme through "Appearance > Themes" panel, but I got the following error: "The uploaded file exceeds the upload_max_filesize directive in php.ini". How can I fix it?

This error is caused by a too low memory limit set on your web server. To fix it, please contact your web host provider with the request to increase the memory limit for uploading files. Or, you can install your theme through FTP.

Once again, thank you so much for choosing this theme. As I said at the beginning, I'd be glad to help you if you have any questions relating to this theme. No guarantees, but I'll do my best to assist. Best regards and have fun with HappenStance!

Tomas Toman

Go to Navigation