First of all, a big thanks for purchasing this theme. This document includes a guide and general information about the theme. Feel free to contact me if you have any questions that are beyond the scope of this document.

If you're planning to build a website using WordPress, you must first ensure your hosting provider meets WP's requirements.

Database

  • MySQL 5.0.15 or higher
  • PostgreSQL 8.3 or higher
  • SQLite 3.3.7 or higher

PHP

  • PHP 5.2.5 or higher (5.3 recommended)
  • PHP5 GD library installed
  • Disabled error_reporting flag on production server
  • Enabled mod_rewrite in Apache for clean URLs
  • Memory limit set up at least 64MB

This theme requires the latest Wordpress version (3.5. +).

There are 2 different ways to upload the theme.

  1. FTP: Unpack the panama.zip and upload the unpacked folder into the wp-content/themes/ folder
  2. WordPress: Login into WordPress and go to Appearance > Add New Themes > Upload. Select the zipped theme file panama.zip and click Install Now.

Enable theme

After copying theme into theme foldre you have to enable it. Please sign into WordPress administration and navigate into "Appearances -> Themes". Click on the "Activate" link.


Enable theme plugins

This step is very important. After activating the theme, you will see a notice about installing plugins that the theme uses. Click on "Begin installing plugins", tick all of the plugins listed and then using the drop down underneath, select Install. Apply. Once they are all installed, click on "Return to Required Plugins installer" and tick all of the plugins once more, but this time, select "Activate" from the drop down and hit apply.


Import demo content by theme

After activating the theme, you will be redirected to the "Theme Options" section of the page. At the top of the page you will see a green button "Import demo content". Click the button and wait until the import has finished. Done!





IMPORTANT: Do not close or refresh the page! This could take several minutes, depending on your internet connection.




Import demo content manually

  1. How to Use the XML File to Import the Demo Site’s Content
  2. Log into your site as an administrator.
  3. Make sure you activated your new theme before proceeding.
  4. Go to Tools > Import
  5. Choose “WordPress” from the list.
  6. Upload the demo content .xml using the form provided on that page.
  7. You will be asked to map the authors in this export file to users on the blog. For each author, you may choose to map to an existing user on the blog or to create a new user.
  8. You will then have the choice to import attachments, so click on the “Download and import file attachments” box.
  9. Please be patient while WordPress imports all the content. Posts, Pages, Projects, and Menus are imported. You will need assi
  10. gn the menu a theme location & you’ll need to configure widgets. This is a limitation of WordPress’ import system.
  11. Enjoy!

NOTE: The demo xml file is located in the "export" folder.


Regenerate theme thumbnails

If you are installing Panama on a website that already has images uploaded, please follow these important steps once Panama is activated:

After logging into your admin Wordpress account:

  1. Go to Plugins -> Add New and install a free plugin called "Force Regenerate Thumbnails"
  2. After Installing and activating it, go to Tools -> Force Regenerate Thumbnails
  3. Click on "Regenerate All Thumbnails" and wait until it is finished

This fixes all your existing images to work with Panama. Any images uploaded after Panama is active will have the appropriate thumbnails created automatically.

After logging into your admin area:

  1. Go to "Appearance > Theme Options > General"
  2. Click the button in the section logo / favicon
  3. Click "Select Files" and open the image you want to use.
  4. Click "Send to OptionTree".
  5. Save the changes.


Create a blog listing page


In order to create a custom journal page with the latest posts, you need to create a custom page with the template "Journal Page".





After you select the template, an additional blog settings will appear:




Select the option you need and save the page.



Blog settings


There are some additional blog settings by going to "Theme Options > Blog"








"You May Also Like" section is displaying the latest posts related to a single article, linked by tags. You can remove it by going to "Theme options > Blog > Show 'Related articles' section in blog posts".





Single article layout type


There are two layout types for a single article, using sidebar and fullwidth:







  • How to create a gallery?
  • How to use a gallery as a page?
  • Gallery archive page
  • Client area
  • Single image settings
  • Before / After image effect



  • In order to create a gallery, please navigate to "Gallery > Add new". Here is how the gallery options look like:




    Just choose the gallery type you need and save.




    In order to display single gallery as a page or homepage, please create a custom page with the template "Gallery Page", then choose the gallery you want and save (optional: then set as a static homepage).







    The galleries are using also categories. This will allow you to display an archive page with galleries. To link such a page to the menu, please navigate to "Appearance > Menus", then click "Gallery Category" from the accordion menu ( if you don't see this option, please clikc "Screen Options" and check "Gallery Category"), and add the category you want. The main gallery images is the "Featured image" of the gallery. if you leave it empty, it will use the first image from each gallery.






    In order to create a Client Area, please create a custom page with the template "Client Area". The you will be able to choose from all the galleries you have:




    The Client Area works like an archive page, but it also includes a filter for the customers. You can aslo use password protected galleries for different customers.




    You will find additional image settings by going to Media Library and editing the images. Use the options to add additional information, photography details with icons, before / after effects or change the header color and set the photo as full screen. Here is how it looks in the admin:









    To add before / after image effect, just edit the image you want by the media section, find and enable the option "Enable before / after image", upload before image and save. This options will automatically hide any of the other icons displayed at the bottom right part of the screen.






    Please use the default wordpress functionality to create a password protected galleries.





    Panama includes our "Peenapo Page Builder", that will allows you to build advanced pages in a minutes. It is very intuitive and easy to manage. After activating the theme, just install the required plugins pushed by the theme.

    Panama can use any of the several hundreds of Google fonts available. You can select one font for the body text (often a clean, light font) and another font for everything else (menu font, titles, etc).

    How to change the current theme font:

    1. Go to "Appearance > Theme Options > Fonts".
    2. Choose the font you want for body and headings. ( After selecting the font, a demo text will appear bellow the dropdown menu to show you how it looks like ).



    3. After you have the font, save the changes.

    To have a contact page like the one seen on the Panama demo:

    1. Go to Plugins > Add New
    2. Search for "Contact Form 7" and install it
    3. After activating the plugin, there will be a new option in your Wordpress bankend. Go to Contact
    4. There will be a default contact form created, simply copy the code of it under "Shortcode" (should be similar to: [contact-form-7 id="59" title="Contact form 1"])
    5. Add/Edit a page with a suitable name
    6. Paste the shortcode code of the contact form
    7. Publish/Update the page
    8. Important: The contact form content used in the demo is this:

      <div class="cf7-form-row">
      <div class="cf7-column-half">[text* your-name 33/ placeholder "Your name"]</div>
      <div class="cf7-column-half">[email* your-email placeholder "Your Email"]</div>
      </div>
      <div class="cf7-form-row">
      <div class="cf7-column-full">[text your-subject placeholder "Subject"]</div>
      </div>
      <div class="cf7-form-row">
      <div class="cf7-column-full">[textarea your-message placeholder "Your Message"]</div>
      </div>
      <div class="cf7-form-row">
      <div class="cf7-column-full align-center">[submit "Send Message"]</div>
      </div>
                                  

    Panama does not force a website to have a specific format to show the title at the top of the browser, this is to provide the freedom to set them up as you wish. It is recommended to install a free SEO plugin such as: All-In-One Seo or SEO by Yoast. Both these plugins will allow you to set the titles as you wish to show them and at the same time improve your SEO.

    Panama comes with everything setup to easily translate it into any language. To translate into a different language:

    1. Go to the theme translation folder, which is located in "panama/languages/"
    2. Make a copy of the file 'default.po' and rename the file to the locale of your language, example: Spanish would be 'es_ES.po'
    3. Open Poedit (can be downloaded for free from http://www.poedit.net/) and open the file you have created in it
    4. Translate all the strings and save your changes. After you save, you will have two files, exaple: Spanish would have 'es_ES.po' and 'es_ES.mo'
    5. Upload these files to "panama/languages/"
    6. Make sure your WordPress config file (located in the root of your website "yoursite/wp-config.php") has the following line set to your locale: "define ('WPLANG', 'es_ES');"

    When Panama is activated it recommends several plugins. One of them is called "Envato Wordpress Toolkit" which when enabled and setup, will automatically alert you on your Dashboard when a new version of the theme is available and allows you to install it with only a few clicks. If you did not install the plugin when you first installed Panama, and wish to install it now, please follow these steps:

    1. Go to "Appearance > Install Plugins"
    2. Hover over "Envato Wordpress Toolkit" and click on "install plugin"
    3. Go to "Plugins > Installed Plugins" and activate "Envato Wordpress Toolkit"
    4. A very good tutorial on how to use this plugin can be found at: http://wpmu.org/envato-wordpress-toolkit-a-themeforest-auto-updater/

    All your settings should remain intact after updating the theme (menu settings, theme option settings, etc).

    Alternative theme update method:

    You can also update the theme manually by going to Themeforest.net, logging into your account and downloading the latest Panama version. For users who are not using a Child Theme:

    1. Deactivate your current Panama version in the Theme section (This can be done by activating any other theme)
    2. Delete the Old Panama theme from your website
    3. Upload the new version of Panama as normal and activate it

    For users who are using a Child Theme:

    1. Delete the Old Parent Panama theme from your website
    2. Upload the new Parent version of Panama as normal and activate it