CFLib.org – cfLipsum

cfLipsum([isFormatted])

Last updated April 29, 2010

author

Version: 0 | Requires: ColdFusion 5 | Library: CFMLLib

Rated 2 time(s). Average Rating: 3.5

Description:
This function allows for outputting lorem ipsum text on the fly. It converts a feed of lorem ipsum text from Lipsum.com into a formatted or unformatted return string for output.

Return Values:
returns a string

Example:

<cfoutput>Formatted Lorem Ipsum:<br />#cfLipsum()#</cfoutput>
<cfoutput>Unformatted Lorem Ipsum:<br />#cfLipsum(0)#</cfoutput>

Parameters:

Name	Description	Required
isFormatted	strips lorem ipsum text of punctuation and uppercase	No

Full UDF Source:

	
	<!---
 Converts a feed of lorem ipsum text into a string for output.
 
 @param isFormatted      strips lorem ipsum text of punctuation and uppercase (Optional)
 @return returns a string 
 @author Bret Feddern (bret@bricecheddarn.com) 
 @version 0, April 29, 2010 
--->
<cffunction name="cfLipsum" output="no" returntype="string" displayname="cfLipsum" hint="get a lorem ipsum string from lipsum.com">
    <cfargument name="isFormatted" type="numeric" required="no" default="1" />

    <cfset var theXML = "" />
    <cfset var theGrab = "" />
    <cfset var theLipsum = "" />
    <cfset var theLipsumFeed = "http://www.lipsum.com/feed/xml" />
    
    <!--- get the xml feed --->
    <cfhttp url="#theLipsumFeed#" method="get" resolveUrl="false" />
    
    <!--- parse and search xml for lorem ipsum --->
    <cfset theXML = XMLParse(cfhttp.filecontent) />
    <cfset theGrab = XMLSearch(theXML, "/feed") />
    
    <!--- only one lorem ipsum element in the feed --->
    <cfset theLipsum = theGrab[1].lipsum.xmltext />
    
    <!--- strips lorem ipsum text of punctuation and uppercase --->
    <cfif arguments.isFormatted neq 1>
        <cfset theLipsum = lcase(rereplacenocase(theLipsum, "[^a-z0-9 ]", "", "all")) />
    </cfif>
    
    <cfreturn theLipsum />
</cffunction>