Working with Your Blog

To begin working with your blog, you will want to enter the administrator (found at: yourblogurl/admin). In the left hand menu you will see various options:

You will want to start by creating an initial blog category. You must have at least one blog category before writing an entry. After you have created a category, you may start writing blog entries.


Blog Entry Editing Options

When working with blog entries, there are a few special tags and features that you can use to enhance your entries:

<more/> : Sometimes a blog entry may be very long. It is preferable to show only a portion of the entry on the main blog and have the detailed link contain the entire entry. By using the <more/> tag in your blog entry, any text after the <more/> tag will only show up on the individual entry display. You must include the closing / in the tag. When blog entries are emailed, only the text before the <more/> tag is included.

<code> : The code tag allows you to wrap sets of code that you want to show up in your entry. For example:

This is a sample entry. Blah blah blah. Here is some code

<code>
<cfset x = 1>
</code>

This is more text.

Any code inside the <code> block will be escaped (< and > tags changed to &lt; and &gt;), color coded, and will have line breaks changed to <br> tags.

<textblock label=""> : A textblock is simply a block of text with a label. You can include textblocks dynamically in your blog entries by using the <textblock> tag:

Here is my standard footer: <textblock label="footer">

Entries can have "enclosures", which are simply attached files. This is a handy way to attach a resource to a blog entry. One of the features of BlogCFC is that if you attach an image, the file will also be included at the top of the blog entry. This is a handy and simple way to display an image with a entry.

Scheduled Releases

BlogCFC supports delayed entries. This means you can write an entry now that won't be displayed until later in the day. Subscribers will not get an email on the entry until the entry is published. BlogCFC will automatically add a scheduled event to handle the entry release.

Draft Mode

BlogCFC technically doesn't support a draft mode, but an entry can be saved with the Released setting to false. This means that the entry will not be shown on the blog. If you want to write an entry and save it without publishing it, simply set the Released value to false.


HTML/XML-RPC Editors

BlogCFC uses a simple text area to handle entry editing. If you want fancier editing, you have two options. One is to simply use an XML-RPC capable blog editor. Your other option is to use an HTML edit control like tinyMCE. I've made this easier by abstracting the textarea field out of the blog editor. You can find this in the tags folder. The filename is textarea.cfm.


Publishing Non-Blog Content

BlogCFC has basic CMS (content management system) capabilities. While the basic blog application works great for diary style entries, there was no way to create basic content outside of the blog. BlogCFC provides additional publishing capabilities by providing support for Pages, Textblocks, and Slide Shows.

Pages

Pages are exactly what they sound like - complete pages of content. So imagine you wanted to add a "About Me" page to your blog. By using the pages feature, you could create a page that describes you. Once you give it a title, BlogCFC will automatically creates a SES (search engine safe URL) for the page and display it in the administrator. All pages live off the page.cfm file. So your "About Me" page might have this url: http://www.yourblog.com/page.cfm/About-Me

You can add any number of pages you want. To link to a blog page, simply use the URL displayed in the administrator. Pages follow the same editing rules that blog entries do. This means you can include code and textblocks directly in the content. The only tag not supported is the <more/> tag.

Textblocks

A textblock acts much like a page. However, these are used for smaller pieces of content. For example, imagine you have a pod with your favorite links. Normally to update this you would need to edit the file and FTP it to the server. Textblocks lets you store the link pod data in the database. To use textblocks, simply use the textBlock application control:

<cfoutput>
#application.textblock.getTextblockContent("links")#
</cfoutput>

Textblocks are identified by their labels so ensure that you do not duplicate two textblock labels. You can include the content of a textblock inside a blog entry by using the <textblock> tag. Please see the blog editing section for more information.

Working with Slide Shows

There are two ways to create slide shows. One way to create a slide show is to simply upload a folder of images underneath your blog's images/slideshows folder. If your folder was named "foo", you have created a slide show named foo. To view the slide show, simply go to: http://www.yourblog.com/slideshow.cfm/foo

BlogCFC will automatically discover all GIF and JPG files in the folder and will create a slide show based on those images. You should do your best to size your images beforehand as BlogCFC will not do any automatic sizing.

The second way to create slide shows is via the administrator. The administrator lets you add, edit, and delete slide shows. It also lets you add titles to your shows as well as captions to your pictures.


Podcasting

Podcasting for BlogCFC was added by Brian Meloche. Podcasting is a large topic so we'll just cover how BlogCFC handles it. We will also assume you've got your MP3 files already prepared and ready to go.

The first thing you need to do is add the MP3 to the blog entry. You can do this either by uploading the MP3 when editing the blog entry, or by using another program (like an FTP client) to upload the MP3 file. You can then manually type in the name of the file in the blog entry.

As soon as you have used an MP3 file for a blog entry, a simple, Flash based audio player will be rendered with the blog entry. Even if you have no plans of being a podcaster, this could be useful for folks who want to attach songs or other sounds to a blog entry.

BlogCFC supports settings for podcasting. They are: itunesSubtitle, itunesSummary, itunesKeywords, itunesAuthor, itunesImage, and itunesExplicit. These settings are used in the RSS feed and are used by various feed readers to help flag blogs with podcasts attached to them.


User Admin

BlogCFC handles security via a simple username/password mechanism. Out of the box, the admin user has the ability to do anything. However, you can create new users and give them specific roles.

Security

Currently BlogCFC ships with a set of roles that allow for control over who can write and publish content as well as manage categories. Who you give access to these features is entirely up to you.
These roles are :

  1. Admin : A special role for the admin. Allows all functionality.
  2. ManageCategories : The ability to manage blog categories.
  3. ManageUsers : The ability to manage blog users.
  4. ReleaseEntries : The ability to both release a new entry and edit any released entry.