<html>
<head>
<title></title> <!-- Leave the title empty -->
</head>
<body>
<div class="multi-part legible" id="first-step" title="First steps">
<h3>Interface discovery</h3>
<div class="fieldset">
<h4>First steps</h4>
<p>In addition to the global help pages, several administration pages have an online help. If javascript is enabled
on your browser, you can see online help at the upper-right position of the page, by clicking on the <img src="images/menu/help.svg" alt="" style="width: 14px; vertical-align: middle;" /> <strong>Need Help?</strong> link. If Javascript is disabled, the help is displayed at the bottom of the page.</p>
</div>
<p>Each administration page will display the same top heading, main menu and footer. <em>(The order given here is what is shown on a computer screen. For mobile devices or tablets, it may vary according to the space available.)</em></p>
<h4 class="pretty-title">Top heading</h4>
<p>The top heading is composed of three elements:</p>
<h5 class="as_h4">Logo</h5>
<p>By default, this logo is the Dotclear logo and links to the administration landing page. However, a platform
manager can choose another logo and redirect towards something else (generally, the service landing page).</p>
<h5 class="as_h4">Blog(s)</h5>
<p>The first element located after the logo shows the <em>active</em> blog, i.e. the blog on which you are acting. If your
installation is composed of several blogs, these informations are available in a combo menu, which lets you switch to another blog.</p>
<p>The link following the blog name opens your current blog in another window or another tab.</p>
<h5 class="as_h4">User</h5>
<p>The link <em>My dashboard</em> gets you back to the blog administration landing page.</p>
<p>The link <em>My preferences</em> leads to the page where you can modify your personal informations, setup the dashboard and choose your interface and editing options.</p>
<p>Surprisingly, the link <em>Disconnect [your login]</em> disconnects you from the administration of your blog (at Dotclear's, we are ergonomy champions!).</p>
<h4 class="pretty-title">Main menu</h4>
<p>The main menu is located on the left side of the screen. It can be collapsed by clicking on its right border (and then uncollapsed by clicking again on it).</p>
<p>It leads to the different administration pages, according to your permissions on the current blog. It is composed of four blocks:</p>
<ul>
<li><strong>My favorites</strong> lists the pages that you have selected as favorites in the <em>My preferences</em>/<em>My Dashboard</em> tab. If you have not selected any favorite yet, this list will contain the default Dotclear set, or the set that has been defined by the platform manager. If you do not want to display this block, you can uncheck the matching checkbox in your dashboard options.</li>
<li><strong>Blog</strong> lists all the pages that enable to feed and setup the current blog, from editing an entry, managing media, choosing the blog appearance or other parameters.<br />
<em>If you do not have administrator rights on the current blog, there will be no other block below that one in the main menu.</em></li>
<li><strong>System settings</strong> links to the pages that allow you to manage the Dotclear installation: blogs management, users and available languages, plugins installation, system settings. If you have rights on several blogs, but no superadministrator rights, you will only see the <em>Blogs</em> entry.</li>
<li><strong>Plugins</strong> enables you to setup the installed plugins. If the plugin settings only impact one blog at a time, its administration page is available from the <em>Blog</em> block, but if they impact the whole installation, they are located here, and only available for super-admin users.</li>
</ul>
<h4 class="pretty-title">Footer</h4>
<p>A free version of Dotclear will be offered to any user who will discover the secret hidden in the footer.</p>
<h3>Help for great beginners</h3>
<p>If you are not familiar with blogs, we recommend that you have a look at our documentation (the whole table of contents is available in the <strong>Documentation</strong> tab of this page) as well as tutorials such as:
<ul>
<li><a href="https://dotclear.org/documentation/2.0/usage/beginners">My first entry, step by step.</a></li>
</ul>
<p>The <a href="https://dotclear.org/forum/">Dotclear forum</a> is a welcoming place where there is no such thing as <em>a stupid question</em>. Don't hesitate to participate if you need help and, why not, to help people in return.</p>
<p class="info">We try our best to use a vocabulary that is easy to understand without specific knowledge. However, if we end up using a technical term, you will probably find its definition in the <a href="https://dotclear.org/documentation/glossary">glossary</a> of our online documentation.</p>
</div>
<div class="multi-part" id="users-doc" title="User manual">
<h3>User manual</h3>
<div class="three-boxes">
<h4 class="pretty-title">Managing the content</h4>
<ul class="from-left">
<li><a href="https://dotclear.org/documentation/2.0/usage/entries">Entries</a>
<ul>
<li>Creating and editing</li>
<li>Entry details</li>
<li>Entry-related actions</li>
<li>Comments and trackbacks</li>
<li>Batch management of entries</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/usage/comments-trackbacks">Comments and trackbacks</a>
<ul>
<li>Follow-up</li>
<li>Management</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/usage/categories">Categories</a>
<ul>
<li>Creating a category</li>
<li>Editing a category</li>
<li>Deleting a category</li>
<li>Sotring the category list</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/usage/tags">Tags (keywords)</a>
<ul>
<li>Adding tags</li>
<li>Tag management</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/usage/media">Media and attachments</a>
<ul>
<li>Creating a sub-directory</li>
<li>Adding files</li>
<li>Downloading a zip archive of the current directory</li>
<li>Change of fill in file details</li>
<li>Adding files directly</li>
<li>Special file types</li>
<li>Attachments</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/usage/widgets">Blog menu content (widgets)</a>
<ul>
<li>Navigation sidebar, Extra sidebar</li>
<li>Default widgets</li>
<li>Adding/removing a widget</li>
<li>Widgets options</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/usage/blogroll">Blogroll</a>
<ul>
<li>Blogroll</li>
<li>Adding a link</li>
<li>Adding a category</li>
<li>XFN</li>
<li>Importing links from an OPML or XBEL file</li>
</ul>
</li>
</ul>
</div>
<div class="three-boxes">
<h4 class="pretty-title">Settings and customization</h4>
<ul class="from-left">
<li><a href="https://dotclear.org/documentation/2.0/usage/blog-parameters">Blog settings</a>
<ul>
<li>Blog details</li>
<li>Blog configuration</li>
<li>Comments and trackbacks</li>
<li>Blog presentation</li>
<li>Media and images</li>
<li>Search engine robot policy</li>
<li>Antispam</li>
<li>LightBox</li>
<li>Save</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/usage/user-preferences">User preferences</a>
<ul>
<li>My profile</li>
<li>My options</li>
<li>My dashboard</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/themes">Blog appearance</a>
<ul>
<li>Choose a theme</li>
<li>Install a theme</li>
<li>Personnalize a theme</li>
<li>Theme editor</li>
</ul>
</li>
</ul>
</div>
<div class="three-boxes fieldset">
<h4 class="smart-title">Additional readings</h4>
<h5>Glossary</h5>
<ul><li><a href="https://dotclear.org/documentation/glossary">All these mysterious words used on the Web and in Dotclear</a></li></ul>
<h5>Input syntaxes</h5>
<ul>
<li><a href="https://dotclear.org/documentation/2.0/usage/syntaxes">Wiki syntax and XHTML equivalent</a></li>
<li><a href="https://dotclear.org/documentation/2.0/usage/syntaxes#to-go-further">To go further</a></li>
</ul>
<h5>Subscription (RSS, Atom...)</h5>
<ul>
<li><a href="https://dotclear.org/documentation/2.0/usage/feeds">What's that?</a></li>
<li><a href="https://dotclear.org/documentation/2.0/usage/feeds#how-do-i-make-it-available-on-my-blog">How do I make it available on my blog?</a></li>
<li><a href="https://dotclear.org/documentation/2.0/usage/feeds#how-do-i-suscribe-to-a-feed">How do I subscribe to a feed?</a></li>
<li><a href="https://dotclear.org/documentation/2.0/usage/feeds#to-go-further">To go further</a></li>
</ul>
<h4 class="smart-title">Help</h4>
<ul>
<li><a href="https://dotclear.org/forum">The Dotclear forum</a></li>
<li><a href="https://dotclear.org/documentation/2.0/faq">Frequently Asked Questions</a></li>
</ul>
</div>
</div>
<div class="multi-part" id="admin-doc" title="Documentation for administrators">
<h3>Documentation for administrators</h3>
<div class="three-boxes">
<h4 class="pretty-title">Installation and update</h4>
<ul class="from-left">
<li><a href="https://dotclear.org/documentation/2.0/admin/install">Installation</a>
<ul>
<li>Prerequisites</li>
<li>Automatic installation</li>
<li>Standard installation</li>
<li>Installing using the wizard</li>
<li>Installing from the config.php file</li>
<li>Completing the installation process</li>
<li>Next steps</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/upgrade">Updating</a>
<ul>
<li>Preparing for the update</li>
<li>Automatic upgrade</li>
<li>Updating the program</li>
<li>Updating the database</li>
<li>Appendix: updating a mercurial copy</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/config">Configuration File (config.php) Parameters</a>
<ul>
<li>Introduction</li>
<li>Parameters</li>
<li>Adding information to the file</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/1-to-2">Upgrading from Dotclear 1.2 to Dotclear 2</a>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/migrate">Migrating from another blogging software to Dotclear</a></li>
<li><a href="https://dotclear.org/documentation/2.0/admin/local-install">Local installation</a>
<ul>
<li>Windows</li>
<li>Mac OS X</li>
<li>Linux</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/install/iis">Installing Dotclear with IIS7</a></li>
</ul>
<h5>Hosting Annex</h5>
<ul class="from-left">
<li><a href="https://dotclear.org/documentation/2.0/hosting">Hosting</a>
</li>
</ul>
</div>
<div class="three-boxes">
<h4 class="pretty-title">Administration</h4>
<ul class="from-left">
<li><a href="https://dotclear.org/documentation/2.0/admin/users">Managing users</a>
<ul>
<li>Existing user list</li>
<li>Creating a user</li>
<li>Modifying a user</li>
<li>User permissions</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/clean-install">Clean installation</a>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/multiblog">Multiblog Installation</a></li>
<li><a href="https://dotclear.org/documentation/2.0/admin/plugins">Managing plugins</a>
<ul>
<li>Installing a plugin</li>
<li>Configuring plugins</li>
<li>Removing a plugin</li>
<li>Updating a plugin</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/themes/blowup">The default theme Blowup</a>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/themes">Blog Themes</a>
<ul>
<li>Choosing a theme</li>
<li>Installing a theme</li>
<li>Customizing a theme</li>
<li>Theme editor</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/aboutconfig">Advanced configuration</a></li>
</ul>
</div>
<div class="three-boxes">
<h4 class="pretty-title">Maintenance</h4>
<ul class="from-left">
<li><a href="https://dotclear.org/documentation/2.0/admin/backup">Backup and restore</a>
<ul>
<li>Import/Export</li>
<li>Files</li>
<li>Database</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/admin/antispam">Spam comment filters</a>
<ul>
<li>Filter organization</li>
<li>Filter configuration</li>
</ul>
</li>
</ul>
<div class="fieldset vertical-separator">
<h4 class="smart-title">Help</h4>
<ul>
<li><a href="https://dotclear.org/forum">The Dotclear forum</a></li>
<li><a href="https://dotclear.org/documentation/2.0/faq#administration">Frequently Asked Questions (Administrators)</a></li>
</ul>
</div>
</div>
</div>
<div class="multi-part" id="guide-dev" title="Developers documentation">
<h3>Developer and Designer resources</h3>
<div class="three-boxes first-child">
<h4 class="pretty-title">Design & Themes</h4>
<ul class="from-left">
<li><a href="https://dotclear.org/documentation/2.0/resources/themes">Themes</a>
<ul>
<li>User guide for themes</li>
<li>The template tags</li>
<li>Appendix</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/resources/themes/inheritance">Themes inheritance</a>
<ul>
<li>Principle</li>
<li>Limitations</li>
<li>Set up</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/resources/themes/tags">Template tags</a>
<ul>
<li>Generalities / utilities</li>
<li>Blog</li>
<li>Entries</li>
<li>Entries pagination</li>
<li>Comments</li>
<li>Comment preview</li>
<li>Pings</li>
<li>Attachments</li>
<li>Categories</li>
<li>Tags</li>
<li>Archives</li>
<li>Languages</li>
<li>System</li>
<li>Widgets</li>
</ul>
</li>
</ul>
</div>
<div class="three-boxes first-child">
<h4 class="pretty-title">Code & Plugins</h4>
<ul class="from-left">
<li><a href="https://dotclear.org/documentation/2.0/resources/tpl">Creation of a tpl tag for a plugin or a theme</a>
<ul>
<li>Introduction</li>
<li>Values</li>
<li>Instructions blocks</li>
<li>Demonstration of the template cache influence</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/resources/plugins">Plugins</a>
<ul>
<li>Writing a plugin</li>
<li>Appendix</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/resources/plugins/help">Building the plugin contextual help</a></li>
<li><a href="https://dotclear.org/documentation/2.0/resources/authentication">External authentication</a>
<ul>
<li>Preamble</li>
<li>A new authentication class</li>
<li>Scenario</li>
<li>Application</li>
</ul>
</li>
<li><a href="https://dotclear.org/documentation/2.0/resources/xml-rpc">XML/RPC interface</a></li>
<li><a href="https://dev.dotclear.org/code/2/">API documentation</a></li>
</ul>
</div>
<div class="three-boxes">
<h4 class="pretty-title">Contribution & Support</h4>
<ul class="from-left">
<li><a href="https://dotclear.org/documentation/2.0/resources/contribute">Contribute</a>
<ul>
<li>Edit this documentation</li>
<li>Share your creations</li>
<li>Report bugs or suggest new features</li>
<li>Localization</li>
</ul>
</li>
<li><a href="https://git.dotclear.org/dev/dotclear">Dotclear source code repository</a></li>
<li><a href="https://dotclear.org/forum">Dotclear forum</a></li>
</ul>
<div class="fieldset">
<h4 class="smart-title">Conventions</h4>
<ul>
<li><a href="https://dotclear.org/documentation/2.0/resources/coding-standards">Coding standards</a></li>
<li><a href="_charte.php">Administration pages chart</a></li>
</ul>
</div>
</div>
</div>
<div class="multi-part legible" id="a11y-ergo" title="Accessibility and ergonomy">
<h3>Accessibility and ergonomy</h3>
<p>The Dotclear interface fulfills almost all the <a href="http://www.w3.org/TR/WCAG20/">WCAG 2.0</a> criterion. We are working towards making Dotclear compatible with <a href="http://www.w3.org/TR/ATAG20/">ATAG 2.0</a> guidelines.</p>
<p>Accessibility and ergonomy are one of our main concern. We regularly run analysis with the help of experts and continuously provide fixes and enhancements.</p>
<p>You can help us by opening <a href="https://git.dotclear.org/dev/dotclear/issues">tickets</a> or by participating on the <a href="https://dotclear.org/forum/">forum</a>. You can also participate in user testing or join our team!</p>
</div>
</body>
</html>