I’ve had a request recently to create a members only section in a farcry site that I developed. I knew this capability was already in farcry, but I had no idea how to do it. So, for anyone else trying to accomplish this, here’s what I did…

First, copy the Anonymous policy group and map it to a users group. The reason we use the Anonymous policy group is because other groups have webtop admin rights so if a general site user logs in and is part of any other group, they will be able to inadvertently access webtop functions by right clicking to access the dynamic menu in the site or by manually entering http://sitename/farcry in the url. This is most-likely not something you will want to give the average user access to.

Once you have the user group and policy group created and have added users to the new user group, create branch specific permissions for the members only section of the website. Remove view permissions from the Anonymous policy and set view permissions for the new group. An anonymous user should not have access to view this branch but the new group you created will.

Ideally, this is all you need to do to have members only access to certain areas of your site. If a user is browsing the site and attempts to view the members only section, they will be prompted to log in. Once the user logs in he/she will be granted access.

If you followed these instructions, the user will be sent to the farcry login page to login but will be redirected to the page they requested. This is not a very appealing way to do this because most of the time you would want a login form styled inside the site you are working on.

So, you’ve got a farcry site up and running and are pretty proud of yourself. That’s great. Now, your client comes to you and says they want a more complicated group policy set up. The default in farcry is to have Contributors, Publishers and Site Administrators. Contributors get access to create and edit content and must request approval from Publishers and Site Admins. Publishers can create, edit, delete and approve content and don’t really need approval from anyone. Site Admins get access to everything including the Admin and Security tabs which are not often used.

Some clients might want something more complicated than that. For example, let’s say we have a site tree (a big one) and the client has a group of people they want to be contributors for part of the site tree and another group of contributors for another part. By default, a contributor has access to the whole site. So, what do you do? Try creating branch specific permissions. Here’s how you do it…

continue reading "Site Tree Branch Specific Permission"

The guy I share an office with is a flex developer and often has problems with simple ColdFusion tasks like form error handling because he doesn’t do them enough. Perhaps others deal with the same situation.

Here’s a generic form error handler.

First, add a little snippet to the form display. I always change the form field label to red if the user did not enter data.

<span style="font-weight:bold;color:<cfif ListFindNoCase(form.errorfields, 'email')>red<cfelse>black</cfif>;">Email Address:</span>
<input type="text" name="email" value="<cfoutput>#form.email#</cfoutput>">

You notice the form.errorfields right? That gets generated in the event/error handler code.

// check for errors in form fields
for (i = 1; i LTE ListLen(form.fieldnames); i = i + 1) {
	if (NOT len(trim(form[ListGetAT(form.fieldnames, i)]))) {
		form.errorFields = listAppend(form.errorFields, ListGetAt(form.fieldNames, i));
	}
}

This simply checks to make sure all fields have data. It does not check the validity of that data so you will need to add that yourself. For an email field, add something like:

if (IsValid(”email”, form[ListGetAt(form.fieldnames, i)])

(This is CF7 specific)

One thing to note is that Radio buttons will not show up in the form.fieldnames if there is not a default value. To add them manually do:

form.fieldnames = ListAppend(form.fieldnames, “radioButton”);

If a field is not required, remove it from the list by doing this:

form.fieldnames = listDeleteAt(form.fieldnames, ListFindNoCase(form.fieldnames, “submitButton”));

Once again, this is very generic and can be extended to be much more robust. But, for a simple form, this works great.

The categoryAssociation is usually used to select categories. I ran into a problem with that because it doesn’t natively restrict the selection to a single category, which I needed. So, after some digging, I found that using a combination of the functions included in application.factory.ocategory got me the result I was looking for.

Specifically, I had a category called calendar under root which I knew would always be there. I needed a list of the categories under calendar. Here’s what I did:

Throw this code inside the select tag and you get this:

<label for="filterBy"><b>Filter By:</b>
			<select name="filterBy">
				<option value="" <cfif len(trim(stObj.filterBy)) eq 0>selected</cfif>>No Filter</option>
				<cfset qCalCats = application.factory.oTree.getDescendants(application.factory.ocategory.getCategoryID('calendar', application.catid.root))>
				<cfloop from="1" to="#qCalCats.recordcount#" index="i">
					<cfset pre = " ">
					<cfif qCalCats.nLevel[i] gt 2>
						<cfloop from="3" to="#qCalCats.nLevel[i]#" index="j">
							<cfset pre = pre & "- ">
						</cfloop>
					</cfif>
					<option value="#qCalCats.objectName[i]#" <cfif stObj.filterBy eq qCalCats.objectName[i]>selected</cfif>>#pre##qCalCats.objectName[i]#</option>
				</cfloop>
			</select><br>
		</label>

I ran into an issue recently where tinyMCE would not allow me to embed a quicktime movie. If you look in the tinyMCE config in the Admin page you will see a list of acceptable HTML tags. embed is not one by default (on FC 3.0.2). I added embed to the acceptable tags but this would still not work. So I worked around it and here’s how:

I created a new InsertHTML snippet for embedding quicktime movies. For more information on InsertHTML snippets, see my blog post on that.

Here’s the code for the snippet:

<!--- @@displayname: Embed Quicktime Movie --->
<!--- @@author: Jake Churchill --->
<cfoutput>
<!-- startEmbed::<embed src="/files/#stObj.filename#" width="330" height="256" autoplay="true" controller="true" quality="high" bgcolor="##ffffff" pluginspage="http://www.apple.com/quicktime/download/" />::endEmbed -->
<!-- delete -->
<br><br>#stObj.filename# embedded successfully!<br>Note: if you wish to remove this file, you must use the "HTML" button and delete the source.<br>This text will not be displayed when the page is viewed.<br><Br>
<!-- end delete -->
</cfoutput>

continue reading "Farcry Embed Quicktime with tinyMCE"

Here’s a really cool trick that I use for clients all the time. In the webtop, when editing the body of an HTML page, below the main tinyMCE editor text area are 2 select boxes for images and files.

The default action for inserting an image is to insert the thumbnail with a link to the full-sized image. But, what if you don’t want that? What if you just want the thumbnail and nothing else?

Inside your /project_folder/webskins/dmImage folder, create a file called InsertHTML_thumbnail.cfm. Call it whatever you want, just make sure InsertHTML_ is at the beginning of it.

Inside that file, please the following code:

<!--- @@displayname: Thumbnail only --->
<!--- @@author: Jake Churchill --->

<cfoutput>
<img src="#application.url.webroot#/images/#stObj.thumbnail#" alt="">
</cfoutput>

Now, go back to the webtop and edit the body again. Under the images select box you now have a dropdown. The dropdown displays all of the HTML snippets that are available. The name displayed is what you put in @@displayname: in the file.

Now, what if you want a text link to say a PDF file?

Put the following code in /project_folder/webskins/dmFile:

<!--- @@displayname: Link to PDF --->
<!--- @@author: Jake Churchill --->

<cfoutput>
<a href="/files/#stObj.filename#" target="_blank">#stObj.label#</a>
</cfoutput>

This will give you a text link with the label of the PDF file (label as entered into the file library). The link will open a new window and display the PDF file, assuming the correct plugin is available on the client machine.

I’m sure everyone’s been browsing the net using Internet Explorer and noticed that annoying “Click to activate the ActiveX Control” thing. This was implemented by Microsoft due to a security flaw but what if you happen to know that what you are embedding is secure?

In this case, use Javascript to embed your flash object. The javascript has to be in a seperate .js file.

Example:

<!-- include .js file -->
<script type="text/javascript" src="/js/writeFlash.js"></script>
.
.
.
<!-- call function -->
<script language="JavaScript" type="text/javascript">
RunFlash(#flashwidth#, #flashheight#, "#flashmovie#");
</script>

And here’s the JavaScript code:

function RunFlash(flashWidth, flashHeight, flashMovie) {
    var oeTags = '<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"'
    + 'width='+flashWidth+' height='+flashHeight+' '
    + 'codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab">'
    + '<param name="movie" value="/files/'+flashMovie+'" /><param name="quality" value="high" /><param name="bgcolor" value="##ffffff" /><param name="wmode" value="transparent">'
    + '<embed src="/files/'+flashMovie+'" quality="high" bgcolor="##ffffff" '
    + 'width="'+flashWidth+'" height="'+flashHeight+'" align="left" wmode="transparent"'
    + 'play="true"'
    + 'loop="false"'
    + 'quality="high"'
    + 'allowScriptAccess="sameDomain"'
    + 'type="application/x-shockwave-flash"'
    + 'pluginspage="http://www.macromedia.com/go/getflashplayer">'
    + '<\/embed>'
    + '<\/object>';
    document.write(oeTags);   // embed the flash movie
}

This is a known farcry bug but one that I run into constantly so I finally took the time to fix it on my install.

When creating a new dmInclude object you are supposed to be given a display method dropdown but it never shows up. Why you ask? I’ll tell you why. And by the way, I have only confirmed this for farcry version 3.0.2 and it only seems to happen if the install uses the pliant webskin.

When you create a new Include it calls /farcry_core/packages/types/_dmInclude/edit.cfm. On line 110 of that file a widget called displayMethodSelector is called. This file is at /farcry_core/tags/widgets/. edit.cfm passes a parameter called prefix set to “displayPage”. Line 33 of /farcry_core/tags/widgets/displayMethodSelector.cfm calls listTemplates.cfm which is in /farcry_core/tags/navajo/ and passes it the attributes.prefix variable that it got from edit.cfm (still “displayPage”). listTemplates.cfm has code on lines 24-31 that looks like this:

<cfdirectory action="LIST" filter="*.cfm" name="qTemplates" directory="#attributes.path#">

<!--- This is to overcome casesensitivity issues on mac/linux machines --->
<cfquery name="qTemplates" dbtype="query">
	SELECT *
	FROM qTemplates
	WHERE lower(qTemplates.name) LIKE <cfqueryparam cfsqltype="cf_sql_varchar" value="#attributes.prefix#%">
</cfquery>

I praise Daemon for doing this case sensitivity check to make sure their product works on all systems. However, I have to scold them for the default value of the prefix variable.

This code is looking for all files in the /project_name/webskin/dmInclude directory with the prefix of “displayPage” but the example files in that directory have the prefix of “display”. THAT is why there’s nothing in the dropdown.

There are 2 ways to fix this but I will only recommend 1. The first, and strongly recommended fix is to change the file names from “display…” to “displayPage…” inside the /project_name/webskin/dmInclude directory. The second and far less recommended way to fix it is to change the default value of the prefix variable in /farcry_core/packages/types/_dmInclude/edit.cfm to “display”.

I recommend the first way of fixing this because in all the other type classes “displayPage” is the standard prefix so it would be a reasonable assumption that “displayPage” is what they meant but it just didn’t come out that way.

To fix this for future installs (if you are using the pliant webskin) go to /farcry_pliant/webskin/dmInclude and rename those files to be “displayPage…”.

I came across problem today in that a client has a menu tree that I built in Farcry. Works perfectly, except for the fact that one of the menu items does not correspond with a page that would be displayed in the content area. This single menu item was to be a pop-up window. So, I had 2 options. Do it the easy way:

In navigation file:

if (qNav.objectName[i] eq "Video Testimonial") {
    // Write Javascript popup instead of a normal link
}

Or do it the Right way.

It took 3 hours of time but I did it the right way *pats himself on the back.

The way to accomplish this is to extend the dmNavigation class and I did so in such a way that you might want to copy it because it makes a lot of sense. I’m even considering submitting this to Daemon’s wiki.

If you search my blog I wrote about this before but that project required adding navigation node specific CSS code. This is much more applicable.

First, I created a new file called dmNavigation.cfc in /project_name/packages/types/. I created a sub directory there called _dmNavigation and copied edit.cfm from /farcry_core/packages/types/_dmnavigation/.

I created a bunch of new properties in my dmNavigation.cfc file and, of course, I extended farcry.farcry_core.packages.types.dmNavigation. (I’ll copy the entire code from that file shortly). Then I added the new form fields and some validation for submission in the edit.cfm file. Then I overwrote the edit function by writing a new edit function in my custom dmNavigation.cfc file. Finally, I changed the nav.cfm file that actually writes out the menu structure. (more on that later)

continue reading "Farcry Navigation (extending dmNavigation)"

I saw this on Dave Shuck’s blog and had to post a link to it. It’s his neighbor’s Christmas lights show.

http://www.daveshuck.com/blog/index.cfm