VisitPress 1.1 Documentation by Tomas Toman


VisitPress

Created: 02/09/2013
By: Tomas Toman
Web: visitpress.tomastoman.cz

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


Navigation

  1. About VisitPress
  2. Theme installation
    1. Update to Premium Version
  3. Theme options
    1. General settings
    2. Colors
    3. Fonts
    4. Social networking
    5. Other settings
    6. Header and footer background color
  4. Widget areas
    1. Sidebar widget area
    2. Footer widget area
    3. Footer copyright notices
    4. Home page slideshow
    5. Header icons
  5. Custom widgets
    1. VisitPress Header Bar Widget
    2. VisitPress Social Widget
    3. VisitPress Twitter Widget
    4. VisitPress Facebook Like Box Widget
  6. Menu areas
  7. Page templates
    1. Sitemap page
    2. Page without comments
    3. Page without Share Buttons
    4. Page without Title
  8. Plugins
    1. Slideshow plugin
    2. Sitemap plugin
    3. Breadcrumb navigation plugin
  9. Custom Shortcodes
  10. Translations
  11. FAQs about WordPress

A) About VisitPress - top

Have you ever been in Tuscany? Do you like Paris? Have you ever visited Amsterdam? With VisitPress, you can explore all these places. Missing here your favorite places? Never mind! You can easily create your own color schemes to suit your favorite locations. Of course, you can use VisitPress for any other purpose than traveling, too! :-)

VisitPress is an easy customizable WordPress blog theme. It is a fully responsive theme that allows for easy viewing on any device.

VisitPress Features

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


B) Theme installation - top

For VisitPress installation, you must follow these basic steps:

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

1. Update to Premium Version

Once you have purchased VisitPress Premium Version, simply delete the "visitpress" folder in "wp-content/themes" directory on your host web server and replace it by folder that you have got by purchasing VisitPress Premium Version.


C) Theme options - top

The options framework is available through the link "Theme Options" located on the upper horizontal admin bar (or via panel "Appearance => Theme Options").

1. General settings

This tab is used for choosing one of the basic color schemes and setting to display or not the main parts of layout (right sidebar, favicon, homepage headline, breadcrumb and post navigation). You can find here the single posts/pages displaying options, too. You can set if you want to display the featured images, dates, categories and authors on individual posts and pages.

2. Colors

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

Tip: If you want to set the color gradient for search box and scroll top box, first select the darkest color of the gradient. Then copy its hexadecimal code and paste it into the field for middle color. Using arrow on the right choose the lighter shade of that color. Repeat this procedure for choosing the lightest color shade of gradient.

Color Options

Color settings panel

Note: The main background color of header and footer is set on panel "Appearance => Background".

3. Fonts

This tab is used for selecting Google fonts for individual headlines and text areas. VisitPress offers more than 200 fonts for choosing. The default fonts are specified in the main stylesheet file (style.css in the main theme folder).

4. Social networking

On this tab, you can choose wheter to display or not the Facebook, Twitter and Google +1 sharing buttons which may appear below your single posts/pages content.

Social Networking

Social networking panel

5. Other settings

On this tab, you can fill your own cascading style sheet information (CSS) for modifying the layout. So you do not have to write your custom CSS straight into the file style.css in the main theme folder. The CSS information defined on this tab appear in the "head" section of source code.

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

6. Header and footer background color

The main (header and footer) background color is not set on the "Color" tab of Theme Options. This adjustment is located in panel "Appearance => Background" where you can use the color picker in section "Display Options" to define the exact shade.

In section "Background Image", you can upload your own pattern or image for displaying in the background of header and footer.


D) Widget areas - top

There are several areas for displaying widgets in VisitPress Theme:

  1. Sidebar widget area
  2. Footer widget area
  3. Footer copyright notices
  4. Home page slideshow
  5. Header icons
Widget Areas

VisitPress Widget areas

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

Sidebar widget area displays in the right sidebar, below the Sidebar navigation. Its name in "Appearance => Widgets" panel is "Main Sidebar". You can put here as many widgets as you want.

Footer widget area displays in the footer as the darker box of 3 widgets. In "Appearance => Widgets" panel, you can see 3 areas for individual widgets: "Footer left widget", "Footer middle widget" and "Footer right widget". This boxes represent those 3 widgets. It is recommended to put only one widget into each of those 3 areas.

The widget area for copyright and other notices displays 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 must remain empty.

4. Home page slideshow

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

5. Header icons

The widget area for displaying Home/Contact/Sitemap links icons in header is reserved for one "VisitPress Header Bar Widget". Its name in "Appearance => Widgets" panel is "Header icons". Put here one "VisitPress Header Bar Widget" and fill the requested URL addresses. Into the field for Contact, you can put URL address of your contact page or your contact e-mail. If you want to insert an e-mail, please add the prefix "mailto:" before that e-mail address.


E) Custom widgets - top

VisitPress Theme offers 4 custom widgets:

  1. VisitPress Header Bar Widget
  2. VisitPress Social Widget
  3. VisitPress Twitter Widget
  4. VisitPress Facebook Like Box Widget

1. VisitPress Header Bar Widget

This widget is ready to use for displaying Home/Contact/Sitemap links icons in header. If you want to display these icons, simply put VisitPress Header Bar Widget into "Header icons" area in "Appearance => Widgets" panel and fill requested URL addresses.

2. VisitPress Social Widget

This widget is ready to use for displaying icons with links to your profiles on social networks and RSS feed. Put VisitPress Social Widget into Sidebar or Footer widget area in "Appearance => Widgets" panel and fill requested URL addresses. These social networks and services are supported:

3. VisitPress Twitter Bar Widget

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

4. VisitPress Facebook Like Box Widget

This widget is ready to use for displaying 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 VisitPress Facebook Like Box Widget into 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.


In VisitPress Theme, there are 2 areas for displaying menus:

  1. Horizontal header menu with unlimited levels of drop-down submenus
  2. Vertical sidebar menu

Menu settings panel is located in "Appearance => Menus". At first create a new menu and assign it to one of two predefined Menu areas. Then in left panels choose required pages/categories or custom links and add them to your new Menu. Then save all changes.

If you want to create a submenu, just drag 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.

Menu

Example of three-levels menu


G) Page templates - top

Beside Default Template, VisitPress offers 4 other custom Page templates. 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 page

"Sitemap" Page template is ready for displaying a sitemap page. If you want to use it, the Dagon Design Sitemap Generator plugin must be activated. The sitemap options can be edited on "Settings => DDSitemapGen" panel.

2. Page without comments

If you want to have only some pages with the possibility to add comments and you don't want to deal with it using "Settings => Discussion" panel, just use the "without-comments" Page template. Pages using the Default template will be ready for adding comments and pages using "without-comments" Template won't display the comment form.

3. Page without Share Buttons

If you want to have only some pages with the Facebook, Twitter and Google+ Share Buttons, just use the "without-share-buttons" Page template. Pages using the Default template will be ready for displaying Share Buttons and pages using "without-share-buttons" Template won't display them.

4. Page without Title

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


H) Plugins - top

Some functions of VisitPress are conditioned by installing some plugins. The recommended plugins are included in the installation folder of VisitPress (folder "plugins"). If some of the recommended plugins are inactive, you can see them in "Appearance => Install Plugins" panel.

List of recommended plugins:

  1. Slideshow plugin - Cyclone Slider 2 by Nico Amarilla
  2. Sitemap plugin - Dagon Design Sitemap Generator by Dagon Design
  3. Breadcrumb navigation plugin - Breadcrumb NavXT by John Havlik

The plugins are modified to ensure the best compatibility with VisitPress. If you will find their newer versions on web, I don't recommend to update them, because all custom modifications will be lost. Plugins updates will come automatic with newer versions of VisitPress.

1. Slideshow plugin

Slideshows are based on Cyclone Slider 2 plugin. You can edit them under "Cyclone Slider" tab in the main WordPress navigation. The plugin provides displaying images, Youtube or Vimeo videos and Custom HTML content in Slideshow. The control is very easy and intuitive. On the right panels of Slideshow editing form, you can set dimensions, transitions effects and other options. Above these panels are generated Shortcodes for simply adding your slideshows into the posts or pages.

If you want to add some Slideshow to top of index page using "Cyclone Slider Widget", please read this paragraph.

2. Sitemap plugin

If you want to use the "sitemap" Page template, the Dagon Design Sitemap Generator plugin has to be installed and activated. This plugin provides many advanced options for displaying pages and posts in sitemap. You can set them on "Settings => DDSitemapGen" panel.

If you want to display breadcrumb navigation above 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 on "Settings => Breadcrumb NavXT" panel.


I) Custom Shortcodes - top

VisitPress offers several custom shortcodes for easy displaying of some HTML objects on pages/posts or 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.) [highlight]HIGHLIGHTED TEXT[/highlight]
Shortcode for displaying color-highlighted text (the color is editable in "Theme Options > Colors").

4.) [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.

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

6.) [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"]


J) Translations - top

VisitPress theme is ready for translation into any language. The .pot file (visitpress.pot) is located in "visitpress/languages" theme folder. VisitPress contains integrated Czech (cs_CZ) language localization. The best way how to make the language localization is creating your own .po and .mo files and adding them in "visitpress/languages" theme folder. If you will 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 CodeStyling Localization plugin and create your language localization on "Tools => Localization" panel.


K) FAQs about WordPress - top

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

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

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.

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

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

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

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

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


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 VisitPress!

Tomas Toman

Go to Navigation