﻿<h1>SQUARE Sidebars</h1>
<h4><blockquote><code><a href="http://www.theme-square.com" target="_blank">by SQUARE</a></code> | <code><a href="http://www.filsdetut.fr" target="_blank">Daniel LAPIDES</a></code></blockquote></h4>

SQUARE Sidebars is a sidebar management plugin for WordPress that allows users to <strong>create and manage custom sidebars</strong> directly from the WordPress administration. It aims at eliminating all the hassle sidebars can create by simply giving the users the magic wand to create, manage and replace sidebars.

The plugin is shortcode based.

<h2>Features</h2>
<h3>For users</h3>
<ul>
  <li>Add and manage custom sidebars and replace existing ones using the familiar WordPress UI.</li>
  <li>Searchable and filterable custom sidebars.</li>
  <li>Shortcode based.</li>
</ul>

<h3>For devs</h3>
<ul>
  <li>The Sidebar Management Tool plugin is fully-based on the WordPress <a href="http://codex.wordpress.org/Plugin_API" target="_blank">Plugin API</a>.</li>
  <li>Uses <a href="http://en.wikipedia.org/wiki/PHPDoc" target="_blank">PHPDoc</a> conventions to document the code.</li>
  <li>This plugin has been translated in English and French.</li>
  <li>This plugin includes a <code>.pot</code> as a starting translation file.</li>
</ul>

<h2>Shortcodes</h2>
<h5><code><strong>[square_sidebars id="sidebar_id"]</strong></code> (same as <code>[square_display_sidebar id="sidebar_id"]</code>)</h5>
This shortcode allows users to display a sidebar in a post/page/custom post type.<br />
The sidebar ID is available in the URL : <code>post.php?post=<strong>sidebar-ID</strong></code>

<h2>Installation</h2>
<h3>Automatic installation</h3>

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don't even need to leave your web browser. To do an automatic install: 
<ol>
  <li>Log in to your WordPress admin panel.</li>
  <li>Navigate to the <strong>Plugins</strong> menu.</li>
  <li>Click on <strong>Add New</strong>.
  <li>In the search field, type <strong><u>"SQUARE Sidebars"</u></strong>.</li>
  <li>Click on <strong>Search Plugins</strong>.
  <li>Once you've found the plugin, you can install it by clicking on <strong>Install Now</strong>.
</ol>

<h3>Manual installation</h3>
<ol>
  <li>Copy the <code>SQUARE-sidebars</code> directory into your <code>wp-content/plugins</code> directory using your favorite FTP program or your hosting control panel.</li>
  <li>Navigate to the <strong>Plugins</strong> dashboard page within the WordPress admin.</li>
  <li>Click on <strong>Activate</strong>.</li>
</ol>

<h2>Contributing and reporting bugs</h2>
You can contribute code to this plugin via GitHub: <a href="https://github.com/daniellapides/SQUARE-Sidebars/" target="_blank">https://github.com/daniellapides/SQUARE-Sidebars/</a>.
