Pivot Documentation Project

about_pivot

Fri, 27 Jun 2008 13:43:00 -0700

FIXME This page is lame. It needs to be updated to include: * A descriptive paragraph; * A feature list; * A link to the credits page; * The reference to the latest release should not have a version number; for the sake of timelessness it should point to the front page of the site where the lates version is always listed and links to download are available.

about_the_gpl

Fri, 27 Jun 2008 13:43:00 -0700

(p) is created and © by Bob den Otter . (mostly, that is. See here for exceptions..) (p) is released under the GPL version 2. You can read the full license. In short it means something like this: (p) is free (as in beer speech). You can use (p) for free. You can also use the code we wrote and turn it into something else, but you have to make the derivatives of this program available for free as well. (like we used some parts of free code, and now I am giving it back to the c…

abuse

Fri, 27 Jun 2008 13:43:00 -0700

The Pivot community is, for the most part, a very well behaved community. Once in awhile we get new members that need to be reminded of the rules. It is for these few people that the following abuse related topics have been written. Spam (not the sandwich meat) Our definition of the term, specifically what sort of posts we consider spam on our forums, has generally come to be understood as:

adding_templates

Fri, 27 Jun 2008 13:43:00 -0700

If you have been using Pivot for a while, and you are familiar with editing templates and setting up weblogs, it's not hard to add a whole new weblog with new templates. Here's how to go about it: Make a dummy of my new weblog. Just a static html page, with dummy Lipsum text. Do not try to make everything look perfect yet, because things always look a little different as soon as there's real content in it. When you're satisfied, upload this new template to my folder. The graphic files used are…

adding_trackback

Fri, 27 Jun 2008 13:43:00 -0700

Since 1.30 trackbacks have been a completely integrated part of Pivot and no action is needed to use it. Read more about the trackback functionality. Pre 1.30 instructions Adding trackback to your Pivot site is pretty straightforward. You need to add some code to your templates, and that's basically it.

advanced_configuration

Fri, 27 Jun 2008 13:43:02 -0700

To avoid bloated / too complex configuration menus, some settings can only be modified by editing the file in a normal text editor. These settings are in general only for advanced users, but some times ordinary users might find them useful too - for example to work around shortcomings of Pivot.

advertise_with_pivot

Sat, 02 Apr 2011 07:39:06 -0700

The program was designed to give back to the community that shows us so much support! People showing support for Pivot through this program will get text or banner advertisements run on our site! A great way to show your support and generate some traffic at the same time!

blocked_phrases

Fri, 27 Jun 2008 13:43:00 -0700

The Blocked Phrases list used in Pivot is an effective method for blocking referer, comment and trackback spam. The list can be found by logging into Pivot and going to . Your help in making this list valuable to the Pivot community is appreciated. If you have an addition to this list please send it to spamlist@pivotlog.net.

changelog

Mon, 14 Jul 2008 12:04:51 -0700

The changelogs for all 1.30.x versions (including alphas, betas and RCs) can be found here: Changelogs for 1.30.x Changelog for 1.40.0 Beta This version contains the SVN changes from r17 to r89 from sourceforge. * New feature: Comment moderation * Big enhancements: Metaweblogs API * Added setting on admin config page - enable/disable XML-RPC - to increase security. * Added PHPDoc comments for all functions in meteweblog.php. * Added support for image/media upload - implemented m…

changelogs_for_1.30.x

Fri, 27 Jun 2008 13:43:00 -0700

New Features in 1.30 Alpha 1 * Full fledged Trackback implementation (thanks to Hans F Nordhaug) * Added Markdown and Smartypants as optional text processing * New Debug tool * Started the change to full Unicode / i18n. (thanks to HIROSHIMA Naoki) * New Moblog tool * Moved Calendar to its own extension * Moved emoticons to its own extension * Added basic metaweblog API capabilities. (thanks to Mngeoff ) * New default templates.

changing_language_file_entries

Fri, 27 Jun 2008 13:43:00 -0700

All that is needed to change a language file entry is a simple text editor. However, you need to be aware that most releases of Pivot introduce a few new strings, so that when updating Pivot you have to replace your language file or Pivot may not work properly. But, if you do, your changes are gone, unless you do some tedious editing by hand with each upgrade.

changing_the_templates

Fri, 27 Jun 2008 13:43:00 -0700

You can use this screen to make changes to your templates, or add whole new templates altogether. This is just a way to edit files in your folder, so you can use other editors for this if you'd like. If you look at the names, you see three sets of prefixes on the filenames:

coding_examples

Fri, 27 Jun 2008 13:43:00 -0700

FIXME

coding_examples_extensions

Fri, 27 Jun 2008 13:43:00 -0700

coding_guidelines

Fri, 27 Jun 2008 13:43:00 -0700

FIXME: Needs to be split into different sections for different purposes.. Or at least point out the things that are relevant to the particular section that it is in. PHP version and dependencies * Pivot works on PHP version 4.1.0 and higher, and php 5.0.0 and higher. * Pivot works on Linux, Freebsd, MacOSX and Windows platforms * Pivot works under Apache and IIS * Pivot runs (to a certain degree) under safe-mode.

configuration

Fri, 27 Jun 2008 13:43:00 -0700

The configuration page sets defaults for all of your weblogs. Site Name This determines the overall name for your website. Default Language This is the default language for your site. This is the lingo you'll see when logging in, and also the language that will be set for new users. It is also the fallback language for Pivot that gets used when it cannot determine what language to use.

contributing_code

Fri, 27 Jun 2008 13:43:00 -0700

This page describes the best way to go about contributing code to Pivot. This needs to be split into three parts: * Non developers providing patches/fixes/whatnot. * Developers changing minor things directly in SVN. * Developers changing major things

converting_from_other_weblog_tools

Fri, 27 Jun 2008 13:43:00 -0700

Currently you can convert/import entries from the following other weblog tools: * * * * * * * * The latest version of the import/convert scripts can be found in our SVN repository. Download the correct script (as indicated below in the section for each tool) and ensure that the files starts with ). Upload this to your server in the same folder as your Pivot install (the one with the entry.php and pv_admin.php files in it). Then follow the instru…

converting_to_other_weblog_tools

Fri, 27 Jun 2008 13:43:01 -0700

Most weblog tools provide import scripts so people can easily switch to the tool - Pivot does this too. However, not all to provides export scripts so people can easily switch from the tool. This is (probably) not because the tool providers want to lock people in, but mostly because they don't have the resources to do it.

creating_an_account

Fri, 27 Jun 2008 13:43:00 -0700

Benefits Guest posting is permitted in most areas of the Pivot Support Forum but it is highly recommended that you crate an account. Posting as a registered user has its benefits: * have the ability to send and receive private messages; * you are able to receive email notifications of replies to your posts; * you, and others, can easily search and find all posts you have made; and * various profile information is made available to other members and guests.

credits

Fri, 27 Jun 2008 13:43:00 -0700

Bob den Otter started this project, but it could have never gotten to the point where it is now without the extensive help of others. In alphabetical order: * Gunnar Lundström (Digits): Support. * Hans F. Nordhaug (hansfn): Developer and bug squasher, maintains core code documentation and wrote and maintains the Pivot Setup script. * Kevin Pascal (Griswald) : Pivotlog.Net Domain, Hosting, Maintenance and Administration of the website, Support. * Lijn Hornstra: Moblog Code. * Ma…

database_problems

Fri, 27 Jun 2008 13:43:00 -0700

If you are having problems with rebuilding your pages and archives (suddenly stops, entries are missing), or rebuilding the index (notes saying “entry 00xxx is NOT ok”), most likely some of the files in the pivot/db/ folder are corrupt. Usually these can be fixed by the db_repair utilities, and if they can not be repaired, at least these utilities will be able to get all the information that is left, and make the broken entries accessible again.

date_formatting

Fri, 27 Jun 2008 13:43:00 -0700

This is an overview of the various options you can use for the formatting of dates in <<>>, <<>>, <<>>, and in the various options in . The options you can use are: %minute% the number of minutes after the hour: from 00 to 59%hour12% inserts the hour from 00 to 11%ampm% inserts either AM or PM%hour24% inserts the hour from 00 to 23%day% insert the day, as a double digit from '01' to '31'%ordday% ordinal day - insert the day, as a number from 1 to 31 [>1.20b1]%daynum% insert the number of the…

dealing_with_open_basedir

Fri, 27 Jun 2008 13:43:00 -0700

If you get messages like this: "Warning: open_basedir restriction in effect. File is in wrong directory in /docroot/script.php on line 2" We suggest you cancel your subscription with your hosting provider, because they have crippled PHP to a point that it has become practically unusable. However, if you are stuck with your provider, Pivot can work if you:

dealing_with_safe_mode

Wed, 23 Mar 2011 12:53:35 -0700

" “Nassssty safe_mode.. We hatesss it, but we have to deal, my preciousss.. ”, Gollum - undated quote.." PHP has a feature called safe_mode. This 'feature' tries to deal with imminent security breaches by crippling or simply disabling parts of PHP. Any server that runs in safe_mode will have some problems running Pivot. It might work, it might not.. There is no way of knowing if it works on your server until you try it. If you do not know if your server is in safe_mode you can look it up i…

download_templates

Fri, 27 Jun 2008 13:43:01 -0700

FIXME

download_themes

Fri, 27 Jun 2008 13:43:01 -0700

Interface Themes are available for download from Pivot Styles.

extensions

Fri, 27 Jun 2008 13:43:01 -0700

extensions20

Fri, 27 Jun 2008 13:43:02 -0700

In Pivot 2.0 there are 4 different kinds of extensions: * Hook Extensions * Snippet Extensions * Widget Extensions * Admin extensions

extensions20_hook

Fri, 27 Jun 2008 13:43:02 -0700

In Pivot 2.0 you can use 'hooks' to alter the behaviour of Pivot. A hook consists of three parts: The name of the hook, the action to take, and the parameters you'd like to pass to the hook. For example:

extensions20_snippet

Fri, 27 Jun 2008 13:43:02 -0700

Snippet Extensions take advantage of the extensibility of the Smarty Template engine, that is used in Pivot. To create a Snippet extension, you must start the name of the extension file with snippet_, it should have a .php extension, and it should be placed somewhere under the pivot/extensions folder. When this is the case, the extension will show up in Admin > Extensions in the Pivot interface.

file_explorer

Fri, 27 Jun 2008 13:43:01 -0700

The built in file explorer is a simple tool to inspect files in your folder. Normally you will not need this, but if you are curious to the contents of some file, you can use this tool to snoop around. This tool also reads the 'serialized' files Pivot generates. Normal text editors will show the files as gibberish, but this tool shows these files so that they're humanly readable.

formatting_tags

Tue, 23 Sep 2008 05:25:45 -0700

Introduction Here you can find a list of all formatting tags which can be used by Pivot to... well, format things! Formatting tags look like %tag%. If you're looking for template <>, look here instead. If you have any questions related to formatting tags, post them to the Pivot Support Forum.

forum_etiquette

Fri, 27 Jun 2008 13:43:01 -0700

The main focus of this discussion forum is to create an open communication channel between Pivot developers, administrators and existing/new Pivot users. For the 'new to Pivot' as well as the 'experienced Pivot user', having the ability to directly communicate with the entire Pivot community is extremely valuable. But how do you maximize the Pivot Support Forum potential?

forum_etiquitte

Fri, 27 Jun 2008 13:43:01 -0700

frequently_asked_questions

Fri, 27 Jun 2008 13:43:01 -0700

This is where we will compile a list of FAQ's. If you see a question on the forum that's been answered several times before, you can put it on this page. Be sure to phrase it in such a way that it will make sense to the people who come here looking for answers.

general_info_languages

Fri, 27 Jun 2008 13:43:01 -0700

General Info Pivot is translated to more than 30 languages. However, not all of these languages are included in the base install. If your language is missing, check if it's available at PivotStyles.net. If you find your language, just download the language file and upload it (pvl_xx.php) to the pivot/langs/ directory of your weblog.

general_info_templates

Fri, 27 Jun 2008 13:43:01 -0700

FIXME

general_info_themes

Fri, 27 Jun 2008 13:43:01 -0700

An Interface Theme is a group of files that defines the look and feel of the Pivot admin interface. Adding additional Interface Themes allows you to select different themes in . Default Theme The default theme looks like this: Example Theme: Drunkey Love An example of a different theme is below:

getting_started

Fri, 27 Jun 2008 13:43:01 -0700

If you want to get started on Pivot, here's the 5-step plan: * Make sure your server runs PHP * Getting the files, and Uploading them - or doing both automatically using Pivot Setup * Configuring and Setting up the first user. * Play around with it so you get accustomed to the interface * Profit!

getting_the_files

Fri, 27 Jun 2008 13:43:01 -0700

To get the latest version of Pivot, go to our Sourceforge project page and then to the files section. Stable and development versions are available for download. Development (or beta) releases will likely contain some bugs. People using Pivot in a production environment or with limited php skills are encouraged to use the latest stable relase. New users should download the full.zip while existing 1.x users should download updater.zip.

helping_others

Fri, 27 Jun 2008 13:43:01 -0700

To most people Pivot is more than just a weblog script. It is an exceptional community of people that not only produces a great opensource weblog tool, they support it. Regardless of your skill level you can always be assured of getting answers to your Pivot related questions on the Pivot Support Forum.

hooks

Fri, 27 Jun 2008 13:43:01 -0700

(Note: Hooks are available starting with Pivot 1.30 alpha 4) Hook Extensions are placed in the hooks/ folder in your extensions folder. So, usually this is extensions/hooks/. There are several places you can insert hooks, that have code which will be executed in specific places of pivot. For example, the pre_comment_submit hook will be executed just before a submitted comment is placed in your weblog. The post_get_referer hook is executed after a referer is added to the list, but before the ne…

ip_blocks

Fri, 27 Jun 2008 13:43:01 -0700

So, you've got a weblog. And visitors. And they react to your entries. Now, you don't mind a little discussion every now and then, but sometimes visitors just go too far, and you'd rather not see them commenting on your site again. Luckily for you, most people nowadays surf the web from high-speed cable- nor xdsl-connections with a fixed IP-address. This means that, by blocking the IP-address of the culprit, you can prevent him (or her) from posting to your site.

licences_of_used_libraries

Fri, 27 Jun 2008 13:43:01 -0700

Pivot uses some libraries.. Some of which were released under the GPL, some of which under other licenses. We have tried to collect parts of these licenses here, to make sure that we're not trying to take credit for other people's blood, sweat and tears.

making_a_purexmlatomfeed

Fri, 27 Jun 2008 13:43:01 -0700

Since version 1.30 beta 3, Pivot supports the the Atom 1.0 feed format. Ideally, we wouldn't have to resort to using CDATA sections to ensure XML wellformedness, but in practice we do. It's a matter of fact that most people do not care about keeping the entries they write wellformed, because all they care about is the fact that the common browsers will show these pages just fine.

mantis_bug_tracker

Fri, 27 Jun 2008 13:43:01 -0700

Bugs are kept in our Mantis bugtracker. There's anonymous access for everybody, so you can see what open bugs we need to fix for the next release. If you've found a bug, and wish to report it, please do so on the Support Forum. Once it's confirmed, we'll put it on the Mantis tracker.

metaweblog_functionality

Fri, 27 Jun 2008 13:43:01 -0700

Pivot has a MetaWeblog API / supports XMLRPC MetaWeblog. XMLRPC clients include desktop blogging clients such as WBloggar, as well as online services such a Flickr. Currently, it is only capable of creating, modifying and deleting posts. Administrative and media functions must be performed from Pivot's web-based control panel.

miscellaneous_tips_and_tricks

Fri, 27 Jun 2008 13:43:01 -0700

Current tips/tricks: * Display a list of your weblog's archives in a page not controlled by Pivot Display a list of your weblog's archives in a page not controlled by Pivot To display the list include the follwoing PHP code in the page: %st_monname% %st_year%
"; $archive_weblog="my_weblog"; include "pivot/pv_core.php"; // suppress debug messages.. $Cfg['debug'] = 0; if (isset($Weblogs[$archive_weblog])) { $Current_weblog = $arc…

moblog_functionality

Fri, 27 Jun 2008 13:43:01 -0700

Beginning with v1.30 Alpha Pivot has a new moblog tool that completely replaces the old one. The new one is more flexible, and it doesn't require gateways or other silly things. Currently it's only available as part of the '1.30 development packages', but after 1.30 is released as a final version, it will become available seperately.

my_info

Fri, 27 Jun 2008 13:43:01 -0700

On the My Info page, you can change and see things about yourself. In the top part you can change your password, and the language you want the Pivot interface to be in. You can also change whether you want the Wysiwyg editor for writing and editing articles to be on or off. See Writing Entries for more on this.

outline_for_pivot_20

Fri, 27 Jun 2008 13:43:01 -0700

This page provides a rough outline of where we want to go with Pivot. Things to add? Don't agree with something? Let's hear it! Finished: Move the code into a new SVN repository at SF.net In an effort to 'not spread things around' we will move our code repository from OpenSVN to Sourceforge's SVN, which services we already use for the file releases.

pivot20framework

Fri, 27 Jun 2008 13:43:02 -0700

The way we put together the screens in Pivot 1.40.x was an atrocity. Screens were scattered about pv_core and pv_admin, named inconsistently. And, the way we compile forms is very evil. We'll need to move all the screens to a seperate code library, name them consistently, and use Smarty as the renderer. This way we can make all the code that outputs screens much more legible and comprehensible to people looking at Pivot's internals.

pivot_setup

Fri, 27 Jun 2008 13:43:01 -0700

Is a small PHP script that enables you to install Pivot very easily and is especially handy when you are faced with a hosting-provider who has turned safe-mode on. * Install directly from SourceForge (without downloading to your local machine and then uploading the files to your host with FTP); OR * Install by just uploading the zip file through the script - no need for an FTP client (or unzipping before uploading).

rebuilding_files

Fri, 27 Jun 2008 13:43:01 -0700

Normally, Pivot rebuilds the frontpage when you post a new entry, or when users leave comments. Sometimes you just don't want to wait for that. Or maybe the backend database of Pivot is corrupted somehow. That's where rebuilding comes in. Rebuild the Frontpage(s) As said above, Pivot rebuilds the frontpage when you post a new entry, or when users leave comments. But what if you made some changes to the frontpage template? You'd want to see that immediately. When you choose this option, Pivot …

sandbox

Fri, 27 Jun 2008 13:43:01 -0700

This page will make you aware of extensions to the capabilities of normal wiki syntax. If you are not familiar with standard wiki syntax you can read more about it here. Template Tags Pivot template tags use the same formatting as wiki markup so they can't just be entered as they appear without screwing things up. Change the [ ] brackets on the tage to < > to make it work!

search_for_answers

Fri, 27 Jun 2008 13:43:01 -0700

The search function accessed through the link at the top of every forum page does work. Really! For those that might have trouble finding the link for the search function we have added the following pretty picture: When you get to the next page simply enter words describing what you're looking for and click search. A picture is worth a thousand words, right?

servers_with_magic_quotes

Wed, 23 Mar 2011 12:55:06 -0700

Some servers have a setting in the PHP configuration that is potentially unsafe. The PHP developers advise against setting this directive. If your server has it enabled, Pivot might not run optimally. Starting with Pivot 1.30 final, if your server has it enabled Pivot will display a notice on the overview screen. There are two ways to remedy this situation: Either have your host disable it altogether, or disable it for just your domain using .htaccess.

servers_with_register_globals

Fri, 27 Jun 2008 13:43:01 -0700

Some servers have a setting in the PHP configuration that is potentially unsafe. The PHP developers advise against setting this directive. Starting with Pivot 1.30 final, if your server has it enabled Pivot will give warnings that this is not safe. There are two ways to remedy this: Either have your host disable it altogether, or disable it for just your domain using .htaccess.

setting_up_categories

Fri, 27 Jun 2008 13:43:01 -0700

You get to the Categories page by clicking from the menu. The top part of the page shows a list of categories and who is allowed to post in them. Creating Categories To create a category, look at the bottom part of the Categories page. Fill in a short, understandable name. Currently you can only use 'normal letters', numbers and spaces. Unfortunaltely you cannot use international charachters yet. Select the user, or users that are allowed to post in this category (hint: to select more than…

setting_up_the_first_user

Fri, 27 Jun 2008 13:43:01 -0700

Open your webbrowser and go to the Pivot you've uploaded and set the filerights for. On the previous page we uploaded Pivot to a folder called weblog. If your server is at www.example.com, that would mean you should go to

setting_up_users

Fri, 27 Jun 2008 13:43:01 -0700

You get to the Categories page by clicking from the menu. The top part of the page shows options for Editing User Fields and Creating New Users. The bottom part lists the users, and allows you to Edit the existing Users Edit Userfields Userfields are custom bits of information about users to use in your templates. Once defined, you can refer to the by using <> in your templates. If you want to create or edit userfields, you will be asked to edit the following fields:

setting_up_weblogs

Fri, 27 Jun 2008 13:43:01 -0700

You can access the Weblogs setup page under . You can add a new weblog or edit any of the current ones. Editing a Weblog. If you edit a weblog, the top part of the first screen will look like this: All the configuration options for Weblogs are spread out over three pages. Most of the options are self-explanatory, so I will only describe the global meaning of these pages:

source_code_documentation

Fri, 27 Jun 2008 13:43:01 -0700

Source code documentation Documentation for the Pivot source code is available in two formats: * phpDocumentor (PHPDoc): * 1.40.x branch * trunk / PivotX * PHPXref: * 1.40.x branch * trunk / PivotX These pages are maintained by the Pivot Team and are normally regenerated every day.

special_thanks

Mon, 24 May 2010 07:38:16 -0700

We would like to extend our sincere thanks to the folks on this page for supporting Pivot. Through their support we have been able to continue to bring Pivot to you! This Year - 2010 (1) Platinum Sponsors * Gambling News Gold Sponsors * none yet!

sponsor_program

Fri, 27 Jun 2008 13:43:01 -0700

Why Support Pivot? People donate to Pivot for various reasons. Some of them are listed below: * a way to say thank you for the countless hours that have been invested in making Pivot what it is today; * to express their appreciation for the exceptional level of support that is offered by the Pivot community; * to offer aid to cover the costs associated with commercially hosting the Pivot site; * an inexpensive way to better their page rank on various search engines.

start

Fri, 27 Jun 2008 13:43:01 -0700

Welcome to the home of Pivot documentation, the Pivot Documentation Project (PDP). This document is not available for download as changes are contsantly being made to it. Many sections of this document are still in need of work and most of them can be identified by the this tag: FIXME They can be easily found by clicking here.

system_requirements

Fri, 27 Jun 2008 13:43:01 -0700

To run Pivot, basically all you need is a webserver that runs PHP. The most common platform on which Pivot is used is Apache (1.3.x or 2.x) with PHP 4.1.0 or higher. (Even if Pivot runs on PHP 4.1.0 we recommend using PHP 4.3+ or 5+.) That's not a firm requirement though.. Pivot also runs fine on IIS servers, and also on Xitami and Zeus, although getting it to run might be slightly trickier on those last two platforms.

system_specific_packaging

Fri, 27 Jun 2008 13:43:01 -0700

Currently you can install Pivot automatically on the following systems: * FreeBSD FreeBSD Pivot is included in the excellent FreeBSD Ports collection. Install instructions: To install the port: cd /usr/ports/www/pivot-weblog/ && make install clean To add the package: pkg_add -r pivot-weblog More information at FreshPorts.org

template_tags

Fri, 27 Jun 2008 13:43:01 -0700

This is a list of all the standard template tags that can be used in your templates. Template tags are also called snippets. This list is included as a reference, and not necessarily as a means to writing your own templates. Inspecting the default templates will give you a much better idea of how it all fits together. Please also read Working with snippets.

template_usage

Fri, 27 Jun 2008 13:43:01 -0700

thankyou

Fri, 27 Jun 2008 13:43:01 -0700

Your donation is appreciated and will be applied to our hosting expenses and other costs associated with bringing Pivot to you. Once your donation has been processed it will be added to our Special Thanks page. Any other actions, based on sponsor level, will also be taken at that time.

the_overview

Fri, 27 Jun 2008 13:43:02 -0700

The Overview is the first screen you see after you've logged in to Pivot.. The most commonly used functions in Pivot are directly accessible from this screen.. In the left column you see the main menu, with access to the several parts of Pivot. Depending on your userlevel you might or you might not see the item. Near the top of the screen are some often used shortcuts, that are always available, independent of where you are inside Pivot. The Area on the right gives a brief overview of the most…

the_pivot_svn

Fri, 27 Jun 2008 13:43:01 -0700

Currently we are using the SVN service at SourceForge - browse Subversion repository. The latest commits can be read as an Atom feed. The code prior to version 1.30.2 was using the SVN service at OpenSVN.

trackback_functionality

Fri, 27 Jun 2008 13:43:02 -0700

Trackbacks have been an integrated part of Pivot since version 1.30. IMPORTANT: Trackbacks before 1.30how to add trackbacks So how do you use trackbacks then? * If you have any old trackbacks (from earlier versions of Pivot) that you want to keep, you have to import them using the import script. * Then you just use the trackback snippets in the templates, just like you use the comment snippets. Available snippets: <>, <> (and <>), <<…

translating_new_languages

Fri, 27 Jun 2008 13:43:02 -0700

First double check that Pivot isn't infact already translated to your language - go to PivotStyles.net. When you are certain that you have to translate from scratch, do the following: * Copy pivot/langs/pvl_eng.php to pivot/langs/pvl_xx.php where xx is the two-letter iso639 code. * Open the file pivot/langs/pvl_xx.php in a text editor. * Change the second line to your language name - in the form Name in your language (Name in English) If the language name, in your language, contains cha…

upgrading_from_older_pivots

Fri, 27 Jun 2008 13:43:02 -0700

This page describes how you can upgrade from older versions of Pivot, like Pivot 0.9 through 0.12.. A tool has been written to convert your entries, but since the template structure has changed considerably, you will morst likely have to make new templates (or adapt your old ones).

uploading_files

Sun, 11 Oct 2009 14:14:08 -0700

To upload the files to your webserver, you can use any FTP client, as long as it allows you to chmod files. We suggest the free and open source FileZilla FTP client. After you've logged on to your webserver, you should create a new folder where you want your weblog to be. Upload all the files in your local folder to this folder.

using_apache_s_filesmatch

Fri, 27 Jun 2008 13:43:02 -0700

FIXME Apache Filesmatch is... * not all servers support this * allows for non-crufty urls * dynamic archives by year, month and category FIXME To use Apache Filesmatch you need to: * do this; and * do this; and * do this too!

using_apache_s_mod_rewrite

Fri, 27 Jun 2008 13:43:02 -0700

Apache's mod_rewrite provides a rule-based rewriting engine to rewrite requested URLs on the fly. This means that you can use nice (non-crufty) URLs like /archive/2006/02/17/title_of_an_entry, and Apache will rewrite (translate) it into the URL /pivot/entry.php?id=123 (which Pivot understands). In other words, if mod_rewrite is enabled, it allows for

using_bbclone_with_pivot

Fri, 27 Jun 2008 13:43:02 -0700

BBclone is a free stats tool for webpages, with a clean interface that gives a quick overview of visitor statistics. Note: Version Check1.30 beta 2 You can use BBclone with pivot to: * Track visitor statistics without spam * Display an overview of the stats on your frontpage * Display the last referers (spamfree) on your frontpage

using_images

Fri, 27 Jun 2008 13:43:02 -0700

Using the 'Manage Media' screen you can add or delete images, and view and edit thumbnails. With the 'Thumbnail View' and 'Complete List View' options, you can toggle between viewing thumbnails or a list of files. You can also upload files with this page.

visitor_registration

Fri, 27 Jun 2008 13:43:02 -0700

Pivot allows your visitors to register themselves. If a visitor is logged in and replies to an entry, his or her name will show up slightly different from 'regular' commenters. This way it becomes harder for someone to pretend he's one of your regular visitors. Registered visitors can also select to be notified (by e-mail) of new posts.

weblogs_categories

Fri, 27 Jun 2008 13:43:02 -0700

Pivot has a versatile weblog structure, which features multiple weblogs, subweblogs and categories.If you want, you can maintain several weblogs with one installation of Pivot at the same time, even sharing or duplicating entries between these weblogs. You can also have multiple subweblogs on one page (most commonly in two or more columns). Pivot comes with one weblog pre-configured, and you can easily add more. If you do not want to have more than one weblog, you can skip to the next section: C…

what_are_extensions

Fri, 27 Jun 2008 13:43:02 -0700

You can currently make two types of extensions: * Snippet Extensions * Hook Extensions Snippet Extensions are pieces of code that define a template <>. Hook Extensions are pieces of code that are included and executed in certain parts of pivot itself. An example of this is how the blacklist is able to do its mojo when a comment/trackback is posted, or when a referer is added.

what_are_they

Fri, 27 Jun 2008 13:43:02 -0700

FIXME

what_is_pivot

Fri, 27 Jun 2008 13:43:02 -0700

Pivot is a tool, written in PHP, to create weblogs and other dynamic websites. Pivot is Free (as in beer speech), and easy to use. Because you place the software on your webserver, you do not need any tools on your own computer, but you can use all of Pivot's functionality through your web browser. This way you can use your Pivot from wherever you like, once you have it up and running.

working_with_archives

Fri, 27 Jun 2008 13:43:02 -0700

Pivot has two kinds of archiving: live pages, generated on demand, and static pages generated when posts are made or edited, or when pages are recreated through the admin panel. Live Archives The live archives are very powerful, and allow the Pivot admin to easily create pages with a list of posts.

working_with_comments

Tue, 23 Sep 2008 05:30:17 -0700

You can allow your visitors to comment on your entries, or not. By default this option is enabled, but you can turn it off in . You can override this setting for certain entries if you wish. If you start a new entry and go to , you'll see an option where you can choose whether or not to allow comments.

working_with_search_results

Sun, 05 Oct 2008 05:56:25 -0700

The information on this page only applies to Pivot 1.40 beta2 and later. This page describes how to format the search result, in other words, what to put in the “Format of Search Results” box on page 3 of the weblog settings. Info about the actual search form/box is not located here, but rather in the template tag page.

working_with_snippets

Fri, 27 Jun 2008 13:43:02 -0700

In your templates and entries you use snippets - also called template tags - to add functionality or content in an easier or dynamic way. Some snippets produce more or less static content, the snippet is just a handy short hand notation. An example of this type is the <> snippet that just produces the URL to the frontpage of your weblog. Other snippets are dynamic (or changing according to context) and very hard (impossible) to replace by hard-coded HTML in your templates. An example of th…

working_with_tags

Fri, 27 Jun 2008 13:43:02 -0700

Note: This functionality is only available in Pivot 1.40 beta 2 and higher!! Inserting tags in your entries When writing an entry, you can add tags in two different ways: Either by inserting them in the text itself, or by adding them to the 'keywords'.

writing_entries

Fri, 27 Jun 2008 13:43:02 -0700

The 'Write a new Entry'-screen is accessible through the shorcut on the top of every screen and through 'New Entry' under 'Entries' in the left side menu. The most common options for writing entries are directly accessible now. By using the 'Extended View' option (near the top right of the window) you can get access to the more advanced options.

your_friend_phpinfo

Fri, 27 Jun 2008 13:43:02 -0700

Phpinfo is a little tool to inspect your PHP install.. It tells you what version is running, whether or not the ghastly safe_mode or the horrendous open_basedir-restriction is in effect. You can get the file here: phpinfo.zip. Download the file, and unzip it on your computer, then upload the resulting phpinfo.php file to your webserver, and access that file on your server using your webbrowser. If your server does not run php, it will look like this: