FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...
DRY up your title tags in CFWheels 2.x. Allows you to define each page's title within it's view.
TitleTag is a resurrection of Grant Copley's YM_Headliner plugin orginally written for CFWheels v0.9.4. I've rewritten it and brought it up to date to work with CFWheels 2.x. Should also be compatible with older versions as well.
If you've used the previous version, then there is a breaking change. The default order use to be "siteName | pageTitle" but now it's "pageTitle | siteName" simply because that's my personal preference.
If your Wheels application has lots of actions and a shared layout, you might find yourself setting custom page title names in your controllers.
Here's an example:
<cfcomponent extends="Controller"> <cffunction name="about"> <cfset title = "About us"> </cffunction> </cfcomponent>
Then, in your views\layout.cfm file, you might have something like this:
<head> <title>My website<cfif StructKeyExists(variables, title)>: <cfoutput>#title#</cfoutput></cfif></title> </head>
This works ... but page titles don't really belong in controllers, do they?
By moving these titles into your views, we can DRY your application a bit and reinforce the MVC design pattern in Wheels.
First, add this code to your main layout:
<head> <cfoutput> #titleTag(siteName="My website")# </cfoutput> </head>
Then, to set the page title, add this to each of your views:
<h1> <cfoutput> #titleTag(pageTitle="My page title")# </cfoutput> </h1>
When views are rendered, the page title will be included in the right spots:
<head> <title>My page title | My website</title> </head> <body> <h1>My page title</h1> </body>
<cfoutput>#titleTag(siteName="My website", separator="—")#</cfoutput> <cfoutput>#titleTag(siteName="My website", separator="—", reverse=true)#</cfoutput> <cfoutput>#titleTag(siteName="My website", separator="—", reverse=true, lowercase=true)#</cfoutput>