The link will help promote <ahref="http://wordpress.org">WordPress</a>
and is its only mean of promotion.
<p>WordPress is built from b2, which comes from Michel V. We wouldn't be
here without him, so why don't you grab him something from his <ahref="http://www.amazon.com/exec/obidos/registry-address-select-done/1XKLC38KDUPXR/103-8901342-4908609">wishlist</a>?</p>
<p>This document is currently beta stage, we'll be updating it extensively
<strong>2.</strong> Open the new b2config.php file and your existing b2config.php file. Modify the new b2config.php file in order to use your existing settings there, in addition to the new settings. (There are a lot of additionnal settings, so it's best to edit the new config file than adding on the exisitng one.)<br/><br/>
<strong>3.</strong> if you want to use the new spellchecker, do a CHMOD 755 on sproxy.pl<br/><br/>
<strong>4.</strong> Edit <u>all</u> your templates and update your template tags
to follow the changes to the template tags here, because there have been some
modifications, and it would cause some errors if you didn't edit the templates.
Tags noted with an orange asterisk <b><fontface="Courier New, Courier, mono"color="#FF9900">*</font></b>
are tags that were added or modified in v0.6, these are those you got
Displays a full link to the previous "set" of posts only if show options set to "posts paged" and if there is a previous set, otherwise nothing is displayed.<br/>
<divclass="params">Parameters:<ul>
<li>A user supplied string. Default "<< Previous Page"</li>
</strong>The function displays a complete navigation set of links including a user definable "separator" with the ability to supply a the text string to be used for the "previous" and "next" links.<br/>
The default result will produce the following string:<br/>
<palign="center"><< Previous Page :: Next Page >></p>
<divclass="params">Parameters:<ul>
<li>A user supplied "separator" string. Default " :: "</li>
<li>A user supplied "previous" string. Default "<< Previous Page"</li>
<li>A user supplied "next" string. Default "Next Page >>"</li>
</strong>Displays links to the pages of the post if it's a multiple pages post.<br/>
<divclass="params">Parameters:<ul>
<li>string to display before the tag (default is "<br />", a newline)</li>
<li>string to display after the tag (default is "<br />", a newline)</li>
<li>"next" or "number": display links like "next/previous page" or links to each page with the number of the page "1 2 3 4 etc" (default is "number")</li>
<li>string to display the "next page" link (default is "next page")</li>
<li>string to display the "previous page" link (default is "previous page")</li>
<li>format string for the "number of page" link (default is "%", where % is replaced by the number of the page)</li>
<li>file name, in case you want to load the posts with multiple pages in a different template (default is the current template)</li>
</ul>
</div>
<br/><br/>
<strong><?php the_author() ?></strong><br/>
The author of the post.<br/>
Depending on the user's profile settings, it can display whether their
nickname, login name, first name, last name, both first& last name,
or last & first name. look below for more author-related template
tags. <br/>
<br/>
<strong><?php the_category() ?><br/>
</strong>the name of the category the post belongs to. you can as an admin
add categories, and rename them if needed. default category is 'General',
you can rename it too.<br/>
<br/>
<strong><?php the_category_ID() ?><br/>
</strong>The ID (number) of the category the post belongs to. This is static
data thatyou can use, for example to associate a category to an image,
This will include the RDF data that can be used by some weblog tools to locate your posts' trackback URLs.<br/>
You should put this tag after the <?php the_content() ?> tag in your template, or just before the end of the loop.<br/>
<br/>
<strong><?php dropdown_cats() ?><br/>
</strong>this is a special tag, meant to be used in the template, but outside of the b2 loop. it will display a list of <option name="<em>x</em>"><em>category-name</em></option>, where <em>x</em> is the number of the category and <em>category-name</em> is the name of it.<br/>
<divclass="params">Parameters:<ul>
<li>0 or 1, depending if you want to have an option to display all categories (default is 1)</li>
<li>text to display for the option to show all categories (default is "All")</li>
</strong>this is a special tag, meant to be used in the template, but outside of the b2 loop. it will display a list of the categories, with links to them. like in b2archive.php, each category is on a line, the only way you can change this is by editing b2.template.functions.php<br/>
<divclass="params">Parameters:<ul>
<li>0 or 1, depending if you want to have an option to display all categories (default is 1)</li>
<li>text to display for the option to show all categories (default is 'All')</li>
<li>sort by: possible values are 'name' and 'ID' (default is 'ID')</li>
<li>sorting order: possible values are 'asc' for ascending or 'desc' for descending (default is 'asc')</li>
<li>filename, in case you want to display the categories' posts in another template (default is current template)</li>
<li>string: can be 'name' to display the name of your weblog (you set it in b2config.php), 'url', 'description', 'admin_email', 'rss_url' to display the URL of your b2rss.xml file, 'pingback_url' to display the URL of your xmlrpc.php file<br/> (default string is 'name')</li>
It outputs the title of the post when you load the page with ?p= (see 'Usage' section for explanation). When the weblog page is loaded without ?p=, this tag doesn't display anything. Generally, you could use it like this:<br/>
It outputs the title of the category when you load the page with ?cat= (see 'Usage' section for explanation). When the weblog page is loaded without ?cat=, this tag doesn't display anything. Generally, you could use it like this:<br/>
It outputs the name of the month when you load the page with ?m= (see 'Usage' section for explanation). When the weblog page is loaded without ?m=, this tag doesn't display anything. Generally, you could use it like this:<br/>
This will display the link to open comments in a popup window, with the number of comments.<br/>
To edit the popup window's template, edit the file b2commentspopup.php (it's the default one for comments popup).<br/>
<br/>
Note:<br/>
The same tags exist for TrackBack and Pingback, respectively named '<b>trackback_popup_link()</b>' and '<b>pingback_popup_link()</b>'. They take the same parameters.<br/>
<br/>
<divclass="params">Parameters:<ul>
<li>string for comment-less posts (default is "no comments")</li>
<li>string for posts with one comment (default is "1 comment")</li>
<li>string for posts with 2 or more comments (default is "% comments")<br/>Note here that the sign "%" is then replaced by the number of
comments.</li>
<li>string for CSS class, so you can have a styled link with class="" (default is empty, no CSS class applied)</li>
</ul>
</div>
<br/>
<br/>
<strong><?php comments_link() ?><br/>
</strong> This is a bit like permalink_link, it will display an URL to the
comments page, but again you'll have to create the link tag.<br/>
<br/>
Note:<br/>
The same tags exist for TrackBack and Pingback, respectively named '<b>trackback_link()</b>' and '<b>pingback_link()</b>'. They take the same parameters.<br/>
<br/>
<divclass="params">Parameters:<ul>
<li>file name, in case you want to use a different template for comments (default is the current template)</li>
This displays the number of comments that have been posted on this post.
Example: "5 comments".<br/>
<br/>
Note:<br/>
The same tags exist for TrackBack and Pingback, respectively named '<b>trackback_number()</b>' and '<b>pingback_number()</b>'. They take the same parameters.<br/>
<br/>
<divclass="params">Parameters:<ul>
<li>string for comment-less posts (default is "no comments")</li>
<li>string for posts with one comment (default is "1 comment")</li>
<li>string for posts with 2 or more comments (default is "% comments")<br/>Note here that the sign "%" is then replaced by the number of
<strong><?php comment_author_email() ?></strong> - displays the e-mail address, but not the link<br/>
<strong><?php comment_author_url() ?></strong>- displays the url, but not the
link<br/>
<br/>
<strong><?php comment_author_email_link() ?></strong><spanstyle="font-family: Courier New, Courrier, mono; color: #ff9900; font-weight:bold;">*</span>- displays a link to the comment's author's e-mail<br/>
<strong><?php comment_author_url_link() ?></strong><spanstyle="font-family: Courier New, Courrier, mono; color: #ff9900; font-weight:bold;">*</span>- displays a link to the comment's author's website<br/>
<divclass="params">Parameters for <strong>comment_author_email_link()</strong> and <strong>comment_author_url_link()</strong>:<ul>
<li>string for the link (default: "email"/"url" depending on the tag)</li>
<li>string to display before the link (default is " - ")</li>
<li>string to display after the link (default is blank)</li>
<li>using <em>blogger.getRecentPosts</em> with the number 'zero' returns all
posts in the blog</li>
<li><em>blogger.getTemplate</em> fetches your file $blogfilename (as specified in
the config), while <em>blogger.setTemplate</em> overwrites it with the edited
data</li>
<li><em>blogger.getUsersBlogs</em> is a dummy function that returns '1' and
$blogname, since b2 supports only one blog as of now</li>
</ul>
<p>If you use blogger.newPost, your post is submitted without title and in category
#1.<br/><br/>
However, you can type <title>my title</title> and/or <category>2<category>
in the body of your post to make its title be 'my title' and its category be #2
(refer to your categories section to find out the ID numbers of the categories). b2 would then delete that extra info from the body of your post once it is posted.<br/><br/>
<br/>
You can now post to your b2 blog with tools like <ahref="http://blogbuddy.sourceforge.net">BlogBuddy</a>, <ahref="http://bloggar.cjb.net">Bloggar</a>, <ahref="http://www.ubique.ch/wapblogger/">WapBlogger</a> (post from your Wap cellphone!), <ahref="http://radio.userland.com">Radio Userland</a> (which means you can use Radio's email-to-blog feature), and other tools that support the Blogger API ! :)<br/><br/>
Your XMLRPC server/path are as described here: if you login to b2 on http://mydomain.com/me/b2login.php, then you have:</p>
<ul>
<li>server: http://mydomain.com/me</li>
<li>path: /me/xmlrpc.php</li>
<li>complete URL (just in case): http://mydomain.com/me/xmlrpc.php</li>
But first you'll have to edit b2config.php, filling the appropriate values for your POP3 email account (this interface doesn't support IMAP yet, only POP3, sorry).<br/>
<br/>
Once you have edited the config options, you can make your webserver execute b2mail.php every set amount of time (depending on your host's performance, this script can be resource intensive, so don't make it run every minute or you'll be kicked).<br/>
You can do it with Cron-jobs, or if your host doesn't support it you can look into the various website-monitoring services, and make them check your b2mail.php URL.<br/>
<br/>
<b>Preliminary advice:</b><br/>
It is strongly advised to send your email as text-only (Outlook and Outlook Express default to 'html', which may cause problems), but HTML email could work (the script would strip all your html tags though...).<br/>
It is also advised not to use your public email address, but create a new one especially for this script. If you use your public email address and the script goes crazy posting every email on your blog and deleting all your emails, I can't take responsibility for this.<br/>
Make sure you delete any email sent to your blog in your 'Sent' folder too, just in case (you don't want someone to find your login and password in the 'Sent' folder).<br/>
<br/>
The script will <i>delete</i> the emails that were used to post stuff on your weblog if it successfully posted your stuff. If it didn't manage to post, the email is not deleted.<br/>
<br/>
<b>How to post:</b><br/>
Now to post something, here's how your email should look like:</p>
<divclass="params">
<b>To:</b> address@domain.com <spanstyle='color: #999'>(you set it in the config file)</span><br/>
<b>Subject:</b> blog:the post's title <spanstyle='color: #999'>(you can change 'blog:' in the config file)</span><br/>
Subject must start with 'blog:', or any string you set in the config file (so that the script doesn't check EVERY email in your mailbox).<br/>
Body's first line must always be login:password, else the script will just skip the email.<br/>
If you don't use '___' (or any body terminator that you set in the config file), the script will post the whole body, which is not what you want if you send email with Yahoo or Hotmail (you don't want their ads on your blog, do you ?).<br/>
<br/>
<b>Special cases for mobile phone email:</b><br/>
Some mobile phone service providers may allow you to send email with your mobile phone or PDA, but on such devices you can't always include line breaks. In such case, you have to set <i>$use_phoneemail = 1</i> in b2config.php, and then here's how you write the email:</p>
<divclass="params">
<b>To:</b> address@domain.com<br/>
<b>Subject:</b> blog:the post's title <b>:::</b><br/>
<b>Body:</b><br>
login:password <b>:::</b> The content of the post, blah blah blah.___
</div>
<p>You will have to append ':::' (or whatever string you set in the config file) after the subject, and after the login:password.<br/>
<br/>
Some mobile phone service providers may not allow you to set a subject, and they'll make the subject be the first characters of the body, in which case you would send an email like this:</p>
<divclass="params">
<b>To:</b> address@domain.com<br/>
<b>Body:</b><br>
blog:the post's title <b>:::</b> login:password <b>:::</b> The content of the post, blah blah blah.___
