For all your questions, wishes and problems go to support.spoon-library.com

database-0.1.zip
Basic documentation.

template-0.1.zip
Basic documentation.

I came across highlight.js and so far it seems pretty reliable. They support quite a few programming languages and colors with their script. And the best part is that the compressed file you download will only contain those languages you want to highlight, which keeps the script fast.

Thanks to the new highlighting I managed to apply another color scheme (thx to Dave Lens for his phpzen theme). Check out the example below.

// This is a single-line comment
$stringvariable = "examplestring";
$intvariable = 300;

/**
 * The description of my test class
 *
 * @author Davy Hellemans <davy@spoon-library.com>
 */
class Testclass
{
	public function test($param = 'default')
	{
		return true;
	}
}

With Spoon Library I'm choosing to take the same route. What does that mean? Well, I've started creating separate git repo's (on github) that only have one package/component. There are no dependencies forced from within the library. If you do need some functionality between packages, there will be a plugin system. Of course you will still be able to download the entire library at once.

Let me give you an example:
The template engine is being tweaked and all hardcoded dependencies for SpoonForm are removed. Instead there will be a 'form plugin' that you can use if you wish to use forms within the template package. Each plugin will list which version of a component is required to be able to use it. That means you will be able to upgrade specific components without having to worry about other functionality. Say you upgrade the template engine to the latest version, then you will be notified if other plugins you are trying to use will cause any known problems.

Only the most basic packages have been somewhat converted to the PHP 5.3 components. You can check them out on github.

I want to thank @yoniweb (Yoni De Beule) for his design skills. He made sure the logo and website look amazing. More thanks go out to @tijsverkoyen for his HTML5 slice work which kicks some serious ass.

Feedback about the redesign/features is always welcome.

Changelog

• Template options may now start with an integer e.g. {option:404}
• The WHERE clause in SpoonDatabase::update and SpoonDatabase::delete may now be null instead of an empty string.
• Added option for headers.sortingIcon in datagrid.tpl - empty <img> elements are no longer shown for default sorting settings.
• Fixed the sorting problem when setting the sortParameter option in a datagrid.
• Bugfix: some classes were using non-existing exceptions, fixed this issue.
• Rewrote a few methods in SpoonFilter for consistency and performance reasons.
• Bugfix: when providing a template to SpoonTemplate::display a few extra checks are performed.
• Bugfix: multiple forms on the same page would produce ambiguous id's resulting in 'invalid' markup.
• Feature: a callback mechanism for exceptions has been added. New constant 'SPOON_EXCEPTION_CALLBACK'.
• Feature: you can now overwrite the token error message in SpoonForm.
• Bugfix: add FOLLOW_LOCATION to SpoonFile::download cURL call so rewrites pose no problem.
• Bugfix: fixed SpoonFilter::isFloat and SpoonFilter::isInteger to work on every float and int instead of relying on regexes.
• Rewrote some small snippets of code to improve performance.
• Bugfix: rewrote SpoonFilter::isInternalReferrer to use PHP's internal parse_url function.
• Bugfix: createThumbnail had been missing from SpoonFormImage.
• Bugfix: form tokens are now working when you have more than one form on your page.
• Feature: SpoonFilter::arrayMapRecursive() now has an optional third parameter $allowedKeys, which allows you to map callback to specified array keys only.
• Bugfix: Custom keys didn't work correctly for SpoonDatagridSourceArray, they do now.
• htmlspecialchars now uses ENT_NOQUOTES by default instead of ENT_QUOTES
• Bugfix: SpoonDatagrid::getColumn no longer triggers an exception when the datagrid contains no results.
• Bugfix: SpoonDropdown::isFilled will no longer equal true when allowExternalData is disabled and the value is not found in the initial list of values. (thx to Dieter Vanden Eynde)
• SpoonFilter::isURL will now acccept domains such as 'spoon.local'
• Feature: added SpoonDirectory::isWritable, a better alternative to the native is_writable function (that can not handle Windows' permissions properly)
• bugfix: fixed SpoonTemplate on Windows for file includes: absolute paths were identified as relative paths
• Feature: added optional parameter to exclude certain columns in all relevant functions of SpoonFileCSV
• Bugfix: SpoonFilter::isURL allows ip(v4 & v6) as URLS from now on
• Feature: when passing null as defaultvalue and type to SpoonFilter::getValue() the return will be null instead of an empty string
• Feature: you no longer need to pass an array with values to a dropdown. A default element will be generated with no value.
• Bugfix: SpoonEmail now uses the charset when building the emails' headers.
• Bugfix: template cycle tags now work as intended. (thx to Matthis Mullie)
• Bugfix: fixed check that used to always fail. Needs to be improved though. (thx to Dieter Vanden Eynde)
• SpoonDatabase now prefixes fields with their tablename (insert/update)
• Exceptions now show the user-agent, if we can find it in the $_SERVER array
• Spoondatabase can now be used with custom ports
• SpoonTemplate does allow empty strings in the cycle-tag from now on.
• SpoonLocale::getCountry added, which allows you to fetch a country in a specific language.
• SpoonLocale: getMonth and getWeekDay added as well.
• SpoonFile::delete now allows you to delete an array of files.
• Rearranged the general authors/owners.
• Bugfix: you can now use named parameters within update queries.
• Bugfix: multiple dropdownfields weren't parsed because of the [].
• Feature: SpoonLocale now contains the supported language names.
• Template-syntax changed for include, iterations & variables
• Unassigned variables don't trigger a notice but gracefully degrade to the template-syntax when SPOON_DEBUG is enabled
• Unassigned forms don't need template recompilation to work when they are in a later stadium assigned
• Cycle-tags now work correctly when nesting an iteration inside itself
• Variables can now go infinitely deep inside associative arrays
• Nearly every character is now allowed as a parameter for parameter-modifiers

The latest tweaks, bugfixes & updates are found on github.

Part 2 will focus more on how you can manipulate the data in your datagrid by using callback functions. Happy coding!

SpoonForm example

Changelog

• The directory structure has changed for some packages.
• A few classes have been renamed based on the above changes. People new to Spoon should have an easier time, trying to find the location of the subpackages.
• Spoon::setObjectReference now also returns the instance you provide it.
• When an exception is thrown, we try to add the last PHP error message if it's available.
• SpoonFilter::isURL now allowes square brackets and semicolons.
• SpoonFilter::replaceURLsWithAnchors now allowes square brackets and semicolons.
• If an exception has a code, this code will be used to link to the documentation section on the website which might contain more information about this specific exception.
• Template cycle tags may now contain a few more characters to give more flexibility in your templates.
• Fixed a bug in SpoonTemplate which prevented first/last options to function normally when your arrays did not start with the 0 key element.
• An extension check has been added to make sure 'mbstring' is loaded before you can use any Spoon class.
• Fixed some comments in multiple files.
• Exception-mails are formatted with inline styles.
• Fixed a performance issue with SpoonFormDropdown in the parse method. (thx to Dieter Vanden Eynde)
• Implemented an autoloader for Spoon.
• SpoonFile::download() now deletes empty file handles when the HTTP return status is not 200.
• Added SpoonDatagrid::getTemplate to retrieve the actual template object being used for parsing your datagrid.
• Added initial version of the new SpoonFileCSV class.
• SpoonFilter::toCamelCase now allowes the separator to be a string OR array.
• Fixed a few issues with invalid markup generated by SpoonForm::getTemplateExample() for radiobuttons/checkboxes.
• SpoonFilter now uses ctype & filter_var functions to speed up some checks methods.
• Fixed an issue with the SpoonDatagrid paging template file.
• An extra method 'createThumbnail' has been added to SpoonFormImage.
• Tokens have been implemented in SpoonForm. They are disabled by default.
• Fixed an issue in SpoonFilter::toCamelCase concerning words with uppercase characters in it. eg SpOoN LiBrarY.
• SpoonFilter::getValue() now accepts arrays for the first argument, as well as 'array' for the returnType argument.
• Added SpoonFilter::arrayMapRecursive(), a way to map multi-dimensional arrays with one or more functions.

Stay tuned!

Next week's tutorial will cover insert/update/delete functionality and the execute() function. Enjoy!

Changelog

• Added SpoonDate::getTimeAgo which presents you with a language dependant sentence based on the provided timestamp in the past.
• Added SpoonTimeField::getTimestamp which returns a timestamp based on the provided values in conjunction with the hh:ii format in the timefield.
• Fixed a bug in SpoonDateField::getTimestamp when not providing all the optional arguments.
• Template modifiers may now contain colons if you encapsulate with single quotes. eg {$now|date:'Y-m-d H:i'}
• Modifiers are no longer allowed within cache/include tags.
• Implemented a few basic checks in SpoonTemplate for variables, iterations and options.