Documentation »

Pinboard Documentation

Installing The Theme

To install themes with the WordPress theme uploader:

  • Download the theme.zip from the member area
  • Login to wp-admin
  • Go to Appearance > Themes
  • Click on the "Install Themes" tab, then click on the "Upload" link
  • Upload the theme.zip (note: it is the theme.zip, not theme-psd.zip) that you just downloaded from the member area
  • Activate the theme

screenshot

You can also install the theme with a FTP software, read this tutorial for more details.

Sample Content

If you are starting a new site and would like to import the sample content as seen on the demo site, here are the steps:

  1. Go to Tools > Import (yoursite.com/wp-admin/import.php). Click WordPress. You may be asked to install the importer plugin. If so, install the plugin.
  2. Upload the sample content XML file included in the theme folder.
  3. You will be asked to map a user to the content and import the file attachments. Check "Download and import attachments" to import the gallery images from our demo site.
  4. Now you may edit or delete the content as you like.

Setting Up The Social Media Links

To set up the social media links:

  • Go to Themify > Settings > Social Links tab
  • The theme comes with some pre-filled social links. Simply enter your social profile URL in the Link input field. For example, enter 'http://twitter.com/themify' for the Twitter link.
  • You can replace the default icons by clicking on the Upload button and uploading your own graphic icon. You may download more free social media icons at IconDock.
  • To add more links, click on the Add Link button at the bottom.
  • To remove link, click on the delete icon.
  • To arrange the display order, drag and drop the link container

screenshot

Displaying The Social Media Links

Once you have the Social Links setup, go to WP > Appearance > Widgets, drop the Themify - Social Links from the Available Widgets panel to the Social Widget panel. Optional: enter the widget Title such as "Follow Us", check to "Show link name" and icon size.

screenshot

Hiding the RSS Icon

To disabling the RSS or social media icons: go to Themify > Settings > Theme Settings (under Exclude RSS link section).

Exclude Search Form

To exclude the search form on the header, go to Themify > Settings > Theme Settings and check "Check here to exclude search form".

screenshot

Custom Menus

To create a custom navigation menu:

  • Go to Appearance > Menu
  • Click on the plus (+) sign to create a new menu (eg. Main Menu).
  • Add the menu items from the left panels (Custom Links, Pages, or Categories)
  • To create dropdown menu, drag the menu item toward the right (the item(s) will be indented)
  • When you are done adding the menu items, click "Save Menu"
  • Then on the top right panel where it says "Theme Locations", select the menu from the dropdown to assign it to the navigation location and click "Save"

Read Custom Menus for more detailed tutorial.

screenshot

Site Logo

To display a logo image instead of text:

  • Go to Themify panel > Styling > Site Logo
  • Under "Site Logo", select "Image" radio button
  • Upload a logo image
  • Specify the image width and height

screenshot

Read Customizing the Site Logo and Description (Tagline) for more details.

Welcome Message

To display a welcome message on the homepage, go to Themify panel > Settings > Theme Settings, enter the text in the Welcome Text box. The content can be plain text or HTML code. Below is a sample welcome HTML text:

<h3>Welcome message</h3>
<p>text here...</p>

screenshot

Infinite Scroll / Pagination Navigation

To set the pagination option, go to Themify > Settings > Theme Settings.

  • Infinite scroll means the posts are automatically loaded when it hits to the bottom of the page. If "Disable automatic infinite scroll" is checked, it will display a Load More button instead of auto loading.
  • Numbered page navigation will display the navigation in page number 1, 2, 3, etc.

image

Social Sharing

To exclude the social sharing buttons, go to Themify > Settings > Default Layouts, under the default index layout and default single post layout, check "Hide share buttons" checkbox.

screenshot

Opening Posts in Lightbox Mode

To open the post in a popup lightbox, go to Themify > Settings > Default Layouts, under the default index layout, check "Open posts in lightbox mode" checkbox.

screenshot

To link the featured image with a lightbox popup such as image zoom, video or an iframe window, enter the URL in the Lightbox Link field under the Themify Custom Panel. The Themify Custom Panel can be found in the post edit page.

  • Sample image: http://themify.me/demo/themes/pinboard/files/2012/06/133618178.jpg
  • Sample video: http://youtu.be/Abjx1JJO1i8
  • Sample iframe: http://themify.me?iframe=true&width=100%&height=100%  (you need to add &iframe=true at the end of the URL)

add image

Lightbox Color Skin/Theme

To change the theme of the lightbox overlay, you can use the 'themify_overlay_gallery_theme' filter in a custom-functions.php that you should create in the theme root folder, pasting the following code in it

<?php
function another_theme($theme){
	return 'dark_square';
}
add_filter('themify_overlay_gallery_theme', 'another_theme');
?>

In the example, the 'dark_square' theme was specified. You can specify these theme names:

  • light_rounded
  • pp_default
  • light_square
  • dark_rounded
  • dark_square
  • facebook

Video Embed

To display a video embed instead of a featured image, enter the video embed URL in the Video URL field under the Themify Custom Panel.

  • Sample YouTube: http://youtu.be/Abjx1JJO1i8
  • Sample Vimeo: http://vimeo.com/6284199

add image

Inserting Gallery to Posts or Pages

The gallery can be inserted in any post or page. To insert a gallery, click on "Add Media" button

addmedia

It will open a lightbox for you to create and insert gallery. Read this tutorial for more details on how to use WordPress Gallery.

creategallery

Author Picture

The author pic is using https://en.gravatar.com associated with your WordPress profile email. Signup a Gravatar account and upload a pic with your email address.

Changing the Comment Limit and Comment Word Count on Homepage

To change the limit/number of comments to appear on the homepage: create a custom-function.php in the theme folder and paste the following code (note: if you already have a custom-functions.php file, just add it in the PHP function):

<?php

add_filter('themify_comments_limit', 'custom_comments_limit');

function custom_comments_limit($comments_limit){
  return 4;
}

add_filter('themify_home_comment_length', 'custom_home_comment_length');

function custom_home_comment_length($words_limit){
  return 10;
}

?>

The first filter PHP function is to change the comment limit number (where it says return 4). The second function is to change the comment word count limit. You may change the return value (where it says return 10) to any number.

Disabling comments in home page

The 'themify_comments_limit' filter is useful to limit the comment number but it also has another important use: if you set the returned value to 0, it will completey hide the comments in the home page. Let's see an example

<?php

add_filter('themify_comments_limit', 'hide_comments_home');

function hide_comments_home($comments_limit){
  return 0;
}

?>

 

Footer Widgets

To set the Footer Widget column layout, go to Themify > Settings > Theme Settings. To drop the widgets in the Footer_Widgets, go to wp-admin > Appearance > Widgets.

screenshot

Footer Text

To replace the default footer text, go to Themify > Settings > Theme Settings (under Footer Text section).

screenshot

Set Fixed Page Width

The page width on the index pages are automatically calculated with Javascript to ensure the post containers fit nicely on the page. Notice when you resize the browser window, the page width is auto adjusted? If you want to set a fixed width instead of the auto width, add this in Themify > Styling > Custom CSS:

/* set fixed width instead of auto width */
#content {
	width: 710px !important;
}
@media screen and (min-width: 980px) {
	.pagewidth {
		width: 978px !important;
	}
}

Setup Multisite Version of Pinboard

Enable WordPress Multisite First

To setup Pinboard as a multisite where users can sign up and post on your site, you need to enable multisite on your WordPress installation first. Here is a tutorial on how to enable multisite.

Importing existing posts from micro sites

Once multisite is enabled, you'll see a menu entry labeled 'Multisite Setup' under the Themify menu in WP Admin. Access it and you'll see a button labeled 'Collect Posts'. Click on it and WordPress will start populating your main site with posts from each micro blog. Depending on your server resources, this might takes a while. Note that the microsites need to use the Pinboard theme in order to sync the posts to the main site. If you want to enable post syncing using different themes, read below.

Enable multisite post syncing using different themes

To enable multisite post syncing to the main site using different themes, you need to copy and include the multisite.php file from 'pinboard' theme folder to all your network enabled themes. You can include the multisite.php file in your theme functions.php file:

if( is_multisite() ) require_once('multisite.php');

Signup and login shortcode

To allow users to login or signup, you may use the [signup_box] and [login_box] shortcode anyway in the post, page, or widget. To insert the shortcode in post or page, paste it in the content box. To insert in a widget, go to WP Admin > Appearance > Widget, drop in a Text widget and paste the shortcode in the text widget box.

Setting the default theme for new sign up sites

You can set Pinboard as the default theme for all new sign up micro sites by following these steps:

  1. Open wp-config.php, located in your site root.
  2. Find this line
    if ( !defined('ABSPATH') )
  3. Before the line, paste
    define('WP_DEFAULT_THEME', 'pinboard');
  4. Save the file.

So your final wp-config.php should look like this:


/* multisite setup */

define('MULTISITE', true);
define('SUBDOMAIN_INSTALL', false);
define('DOMAIN_CURRENT_SITE', 'yoursite.com');
define('PATH_CURRENT_SITE', '/');
define('SITE_ID_CURRENT_SITE', 1);
define('BLOG_ID_CURRENT_SITE', 1);
define('WP_DEFAULT_THEME', 'pinboard');

/* enable multisite */
define('WP_ALLOW_MULTISITE', true);
$base = '##your_wp_directory##';

Important note: you must replace '##your_wp_directory##' with your own directory for the WordPress installation.
If it's installed in the domain root, like for example, in http://www.example.com/ you must add:

$base = '/';

If it's installed in a subdirectory, like for example, in http://www.example.com/subdirectory/ you must add:

$base = '/subdirectory/';

Author name

The author name can be set at WP Admin >  Users > Edit Profile screen (select from the "Display name publicly" dropdown).