1. Getting Started - Installation

    Make sure you've got the current version of WordPress. In order to download the current version, please visit http://wordpress.org.

    Please check http://codex.wordpress.org/Installing_WordPress for information on how to install WordPress on your server.

    Once WordPress is successfully installed, you will have to upload the theme to your WordPress directory - there are two ways to do that:

    • Un-zip the theme main file and upload the folder via a FTP program to the /wp-content/themes/ folder on your server.
    • Use WordPress Theme Installer. Go to Appearance > Themes > Install Themes, and select the zipped theme file.

    Once the theme is installed, you'll just have to activate it in Appearance > Themes > Manage Themes.

    Important step! Please go to Settings > Permalinks and change the Default to Post name. The ajax loading will not work if the Permalink structure is set to Default. Check Setting Permalinks section in WordPress Codex if you encounter any problems.

    Permalinks
  2. Setting Up Your Site - Theme Options

    The PANES theme comes with an easy Theme Options Panel divided into five tabs: BASICS, CONTACT, STYLE, POST and SOCIAL. Each field is accompanied by a short help text. Below we briefly discuss the most important options.

    Options
    1. Basic Options

      Use BASICS tab to upload your logo, both in standard and retina resolution. If you don't upload your logo, your Site Title will be displayed instead.

      In BASICS tab you can also upload your favicon and an apple-touch-icon.

      It's here where you can upload a custom background image for your 404 Page Not Found error page.

      In BASICS tab you can also paste your Google Analytics (or any other) Tracking Code.

      If you want that the left (navigation) sidebar does not show on page load, or if you prefer that it does not hide after scroll - you can set it here.

    2. Contact Options

      Use CONTACT tab to set your all your contact data (address, phone, fax, e-mail). You may also overwrite the admin's email address by a custom one used for the contact form destination or disable the contact form.

      If you want to activate Google Maps on your site, you have to provide the longitude and latitude coordinates of your location at the bottom of the CONTACT tab. If you don't know your coordinates, find them with Google Maps, for example on http://itouchmap.com/latlong.html

      Options Contact

      The CONTACT tab settings will be used in your "Contact Pane" - check the "Contact Pane" part.

    3. Style Options

      Your site's unique look will be achieved thanks to your custom background images (more about in the following section). Besides that you can set your custom colors for links and buttons and the "more content" links. Use STYLE tab to set three colors you wish to use.

      Styles

      You can easily replace the default Open Sans and BenchNine by some Google Fonts. Just paste the font name in the Body Font and/or Heading Font fields. Make sure to choose the font family that we'll be used as a replacement font in case if for some reason the google font can't be loaded.

      Body Font

      The body font is used within the template in three variants : Normal (weight 400), Italic (weight 400) and Bold (weight 700). For the proper rendering make sure to choose the body fonts that supports these three styles.

      Google Font

      You can also add some custom styles in the Custom Styles field.

    4. Post Options

      In the POST tap you can disable/enable which of the post meta data (published date, post's author, post's categories) is displayed.

    5. Social Options

      There are 12 ready-to-use social network links built into the theme: TWITTER, GOOGLE-PLUS, FACEBOOK, DRIBBBLE, PINTEREST, INSTAGRAM, FLICKR, TUMBLR, GITHUB, LINKEDIN, VIMEO and YOUTUBE.

      To activate any of them just paste the URL (ex. http://twitter.com/pehaa) of your social profile. The social icons will appear in the left navigation sidebar and on the bottom of your contact page.

  3. Building Your Site

    Let's start to build your one-page website. It will be composed of all the "Panes" that you create in the WordPress interface. You define the order in which they appear in the Page Attributes meta box on your right. The pane with a higher order appears first.

    Set your pane title in the Title field. Next go to the Pane Settings meta box below your text editor and set your pane subtitle, the shortened pane name to be displayed in the navigation menu together with the menu description.

    Use the Pane Excerpt editor to add some pane-related introduction.

    You can also choose one of the available icons to illustrate your pane content.

    To add a background image, upload it as a Featured Image (meta box on your right). The images used in the demo are about 1500px x 800px and don't exceed 200kB. You can also set the background position that controls the way your background is scaled when you change the window size. You set it in the Pane Background Position field in the Pane Settings meta box below your text editor, the default value is center/center.

    Whatever you type in the main text editor will be visible as the "read-more" content.

    Page

    In version 1.2. we added a checkbox "Check if you want your pane to open automatically on home page". This way you can decide to skip the "read more"" window for each pane individually.

    1. First - "Home" Pane

      There is some specificity about the first "Home" pane. First of all note that your logo (or Site Title) will be displayed automatically.

      Often you will not add any "read-more" content here - just don't put anything in your main text editor.

      You don't need to set the pane subtitle - your site Tagline will be displayed instead.

      You don't need to set the Menu Description - if you don't a little home icon will be displayed instead.

      Also don't choose the icon - it will not be displayed in the first pane.

    2. Showcase Pane

      You can add a filtrable showcase of categorized items as one of your pane. Choose the Showcase Pane option in the Pane Type field. The "read-more" content will be generated automatically from the published Items.

      You can either choose all projects or select a subset to be displayed in a page by choosing a project category. If you choose a filtrable portfolio the direct child categories will be used as filters. In the screenshot below see an example of the project category hierarchy and filtering options

      In order to add an Item, go to Items > Add New. Set the Featured Image - it will be displayed in the showcase. Set also the title and the subtitle. You can add some content in the main text editor - it will be loaded with ajax once an item is clicked.

      In order to have a filtrable showcase, add categories to your items. Make sure that the total number of categories is not too big - they will be all listed.

      Item
    3. Recent Post Pane

      You can also display the last published post. Choose Recent Post Pane in the Pane Type field.

      Note that if you want to add any of the available WordPress widgets, they will be displayed below the recent post in the Recent Post Pane.

      Note that PANES Theme is not a typical blogging theme and it does NOT support comments.

    4. Contact Pane

      Choose Contact Pane in the Pane Type field to activate a Contact Pane. That will automatically add Google Maps, your address, contact form and social icons (see Setting Up Your Site - Theme Options section). Besides that you can add some content in the main text editor.

    5. The navigation menu is generated automatically. You may create your custom user menu in Appearance > Menus. It will be added below the automatic menu (doubled links to Panes will be deleted). Note that clicking on these links you will leave the one-pager.

  4. Shortcodes

    Shortcodes

    There is a bunch of custom shortcodes added to the template. If you are using the Visual editor, click on the "Shortcodes" button and select your desired shortcode from the dropdown menu - it will be added at your current cursor position.

    Two-colums
    Edit the First Column Content and Second Column Content between the related opening and closing tags. Sh Twocolumns
    Team member
    Edit the url, title and content within the [team-member-img] tags and name, role and content within the [team-member-info] tags. Tip: It looks good when inserted as the two-columns content. Sh Teammember
    Slideshow
    There are four slides by default, but you can delete or copy-paste the [slide] tag. Edit the url and caption (may be left empty) parameters for each [slide] tag. Sh Slider

    In version 1.1.3. we added two additional parameters to slide: is_inner_link and open_pane_after_scroll. Set "is_inner_link = true" if you want to add a link to another pane and open_pane_after_scroll="true" if you want that the "read-more"" content opens automatically, ie. [slide url="" href="#pane-59" is_inner_link="true" open_pane_after_scroll="true" title="View features" label="Click here"]Aenean lacinia bibendum nulla sed consectetur.[/slide]

    Toggle
    Edit the title parameter in the [toggle] tag and the content between the opening and closing tag. Sh Toggle
    Testimonial
    Edit the by parameter in the [testimonial] tag and the content between the opening and closing tag. Sh Testimonial
    Button
    Edit the url and label parameters in the [factory-button] tag. Note that the buttons have the same colors as links. Sh Buttons

    In version 1.1 we added two additional parameters to button: is_inner_link and open_pane_after_scroll. Set "is_inner_link = true" if you want to add a link to another pane and open_pane_after_scroll="true" if you want that the "read-more"" content opens automatically, ex. [faktory-button url="#pane-59" is_inner_link="true" open_pane_after_scroll="true" label="Click here"]

    Callout
    Edit the url and label parameters in the [callout] tag as well as the content between the opening and closing tag. Sh Callout

    In version 1.1 we added two additional parameters to callout: is_inner_link and open_pane_after_scroll. Set "is_inner_link = true" if you want to add a link to another pane and open_pane_after_scroll="true" if you want that the "read-more content"" opens automatically, ex. [callout url="#pane-59" is_inner_link="true" open_pane_after_scroll="true" title="View features" label="Click here"]Aenean lacinia bibendum nulla sed consectetur.[/callout]

  5. Import the demo content

    For your convenience we put together all posts, projects and pages into a panes_data.xml file ready for importing into your WordPress installation.

    In order to import this sample data go to Tools > Import and choose "WordPress" from the list, upload the demo.xml file, make sure to check "Download and import file attachments".

    You will need assign the menu a theme location and configure widgets and theme options yourself.

  6. Child Theme

    The Panes Theme comes with a ready to use child-theme. You'll find the "panes-child-theme" folder in the theme package.

    Check WordPress Codex to learn how to use child themes.

  7. Translate Your Theme

    Download and open POEdit. Go to File > Open and choose the translation/default.po file in your theme folder. Line by line translate the theme to your language. Go to File > Save as.. and save your filed in the same subfolder. Name your file accordingly to WordPress language codes, you may find them here. For example the language code for French is fr_FR so you would save your file as fr_FR.po.

    Note that the fr_FR.po file will be automatically compiled to fr_FR.mo file.

    Open the wp-config.php file (in your WordPress install folder), find the line containing

    define ('WPLANG', '');
    and change it according to your language codes, eg.
    define ('WPLANG', 'fr_FR');
  8. Troubleshooting

    Icon Fonts:

    If the font icons don't display properly in Firefox and newer versions of Internet Explorer, probably you're running a in cross domain request issue. In these browsers your web fonts served from a different domain need to have the appropriate “Access-Control-Allow-Origin” response header. You'll have to modify the .htaccess file (see Icomoon documentation)

    			
    				# For Apache
    				<FilesMatch ".(eot|ttf|otf|woff)">
    				Header set Access-Control-Allow-Origin "*"
    				</FilesMatch>
    
    				# For nginx
    				location ~* \.(eot|ttf|woff)$ {
    					add_header Access-Control-Allow-Origin *;
    				}
    			
    			

    Featured Images:

    There are several image size variants used in this template, they are generated by WordPress during the image upload. If your images are already uploaded please use the Regenerate Thumbnails plugin, that will generate the missing sizes for you.

  9. Used assets

    Fonts :

    We use two web google fonts Open Sans and BenchNine and a custom build of icon fonts from Icomoon.

    Images :

    Images used in the demo are mostly by ourselves, there are always some stock photos from Shutterstock. Images are not included in the download files.