Configuring BlogCFC

  1. The Blog INI File
  2. INI Settings and Descriptions
  3. Mobile INI File
  4. Setting the theme for your blog

The Blog INI File

In the previous section, I described editing the Blog INI file (org/camden/blog/blog.ini.cfm) to set the DSN. There are other settings you should edit as well. You do not have to edit this by hand. There is an administrator tool for editing this file. Here is a typical set of entries:

				dsn=blogdev
				username= 
				password= 
				owneremail=ray@camdenfamily.com 
				blogURL=http://www.coldfusionjedi.com/index.cfm 
				blogTitle=BlogDev 
				blogDescription=The Dev Blog 
				blogDBType=MSSQL 
				locale=en_US 
				users=admin 
				commentsFrom= 
				failTo=
				mailserver= 
				mailusername= 
				mailpassword= 
				pingurls= 
				offset=-1 
				blogkeywords= 
				ipblocklist= 
				maxentries=10 
				usecaptcha=1 
				usecfp=1 
				allowgravatars=1 
				moderate=1 
				filebrowse=1 
				settings=1 
				imageroot= 
				itunesSubtitle= 
				itunesSummary= 
				itunesKeywords= 
				itunesAuthor= 
				itunesImage= 
				itunesExplicit= 
				installed=0 
			

The section name, [default], refers to the name of the blog. If you have only one blog, leave this as default. If you have more than one blog on a server, you will want to copy the [Default] section and give it a new name, like [Other Blog]. You will then want to edit the Application.cfm file in the client folder and modify these lines:

				<!---Edit this line if you are not using a default blog ---> 
				<cfset blogname = "Default"> 
			


INI Settings and Descriptions

dsn Specifies the datasource for your blog. BlogCFC supports multiple blogs in one DSN.
username , password If your datasource requires a username and password, supply it in the username and password keys.
owneremail Should be your email address. This is used when comments are posted to your blog.
blogURL Should point to the URL of your blog. BlogURL MUST include the index.cfm file at the end. So if your blog is located at blog.org, do not simply use: http://www.blog.org. Instead, use the full URL: http://www.blog.org/index.cfm.
blogTitle , blogDescription Used in the RSS feed and in the main layout's top title bar.
blogDBType Should either be MSSQL (for SQL Server), MYSQL (for MySQL), ORACLE (for Oracle), or MSACCESS (for Access).
locale This is the locale setting for your blog. This is not a standard ColdFusion locale value, but a standard Java locale.
user A list of users that are the users allowed to use the blog. If you do not specify a list of users, any user in the admin table can use the blog.
commentsFrom By default, comments are emailed out using a "from" address of the person who sent the email. If you set a value for commentsFrom , the email will instead be marked with that address. What that means is that when a user posts a comment to a blog entry, each email sent to the unique users of the thread will get an email from the address specified in that setting.
failTo Specifies a failTo email address to be used for emails sent out from BlogCFC. Note that not 100% of all email operations make use of this feature yet.
mailserver , mailusername , mailpassword

By default, the blog will send emails using the mail server specified in the ColdFusion Administrator. If you want to override that setting, use the mailserver , mailusername , and mailpassword settings. You do not need to specify the username and password if your mail server doesn't require authentication.

pingurls The pingurls setting lets you add ping support to your blog. This is described later in this document in the Ping section.
offset The offset property allows you to offset the posted dates of your blog entries. So if your blog server is in EST and you live in the CST timezone, you can use offset=-1 to have the times of blog entries reflect your timezone.
blogkeywords The blogkeywords setting will be used in the meta tag of your blog. This should describe, in general, the content you plan on blogging about. It should be a list of keywords, separated by a comma. Spaces are ok. Here is an example: "coldfusion, star wars, lost"
ipblocklist The ipblocklist setting is a set of IPs that are prevented from adding comments to the blog. This could be used to block spammers or other people who may abuse your blog. You are also allowed to use wildcards. 192.168.1.* would block comments from anyone whose IP is in the range from 192.168.1.1 and higher.
maxentries The maxentries setting controls how many entries are shown on your blog at one time.
usecaptcha The usecaptcha setting determines if CAPTCHA checking is turned on. If this setting is true, a reader will be forced to enter text from a CAPTCHA image before adding comments or sending blog entries.
usecfp Another method of spam protection is CFFormProtect. This is a spam blocker that checks multiple things that can flag a spammer. To enable this, set the usecfp value to 1. You can further confige cfformprotect by modifying the configuration information in the cfformprorect folder. Currently this is only used on the comment form, not the 'Send Blog' form.
allowgravatars Gravatars are a way to host images that represent a user's email address. If you turn on allowgravatars , BlogCFC will attempt to load a gravatar for each person's email address. If the person is not using Gravatar, a default image will be loaded instead.
moderate The moderate setting determines if comment moderation is turned on. When moderation is on, comments will not show up on your blog until you approve them. You can approve them in one click via the email sent to you or via the Administrator.
filebrowse The filebrowse setting determines if the file manager is available in the administrator. The file manager lets you upload files to your blog. You may want to disable this for clients who can't be trusted to not screw up their own file system.
settings The settings setting determines if the settings tool is available in the administrator. Like the filebrowse setting, you may want to turn this off if you think it will be too much for the client.
imageroot The imageroot setting helps determine where images are stored. These are images uploaded in the blog editor and slide show images. The default value is blank and results in images being uploaded directly in the relevant folders.
usetweetbacks The usetweetbacks option determines if TweetBacks should be enabled for blog posts. TweetBacks are twits (from twitter.com) about your blog post. BlogCFC will make use of SweetTweets to search Twitter for short URL versions of your blog entry. This results in a slight delay on the first hit to your blog post, but the results will be cached for a few minutes.
installed The installed setting is a marker that flags BlogCFC as having been setup and installed. You should set this to 1 if you are manually configuring BlogCFC.

The last batch of settings (the itunes group) all relate to podcasting. Please see the section on podcasting for more information.


Mobile Site Configuration

The mobile ini file, mobile.ini.cfm, can be found in the "/mobile/config" under the client folder. Editing the mobile.ini.cfm is similar to the main blog.ini.cfm file. Options available in this ini file are :

			title=blogCFC Mobile
			shortTitle=BlogCFC
			iconLabel=blogCFC
			appVersion=1.0
			theme=jqt
			mobileRoot=www.blogcfc.com/mobile
			gaAccount=		
			


Setting the theme for your blog

Since version 5.9.8, BlogCFC has come pre-packaged with Arclite theme by digitalnature. When you initially install blogcfc it comes with all the default styles applied. However, there are a number of different styles that you can chose between to make your blog more unique.

The styles for the Arclite theme are split in to four files. A common styles file and then a header, content and side panel style files.
There are several different style options available for the three display areas all of which can be found in the /includes/styles folder.

The header has the most style options available :

The side bar has four styles available :

The content area has three styles available :

To apply different style options to your blog simple edit layout.cfm found in the "tags" folder. About a third of the way down in layout.cfm you'll find four style imports. One for the common stylesheet and one each for header, content and side. Replace the style name in the appropriate import with the one you've chosen from the lists above.

The layout of your blog is cached so you will need to initialise your blog to get the changes you make to be displayed.