Content last modified Tuesday 24 August 2021
hop to #bottom
Author's website
Current version:
About It:
Get it:
Rate it:
  • Helpful?
  • 5 Yes
  • 5 No
Flag it:

If you'd like to provide updated information and do not have access to directly edit, please contact the site admin; thanks!



Outputs the specified Microsoft Excel (.xls) file as an xHTML table. Includes server-side caching for optimum performance.

This plugin is ideal for enabling clients to publish/maintain tabular data without having to know xHTML. A new xHTML table is created and cached every time a new version of the spreadsheet is uploaded.

Basic usage

<txp:rcb_excel file="spreadsheet.xls" />

The file attribute accepts either the name or ID of an uploaded MS Excel (.xls) file.

Note: the plugin will attempt to create a cache directory in your files directory. If PHP lacks the permissions to do this, you will need to create the directory yourself. The default name for this directory is cache, though you can call it whatever you want. If you choose a different name, remember to use the cachedir attribute (see below).

Additional tag attributes

Attribute Description Default
file The Microsoft Excel source file. Accepts either a filename or file ID. The file must already have been uploaded from within the ‘Files’ tab in your Textpattern control panel. unset
sheet The worksheet number to output. 1
style Whether to retain the worksheet’s formatting styles (1) or return unstyled data and markup (0, default). 0
showrownumbers Whether or not to output the spreadsheet’s row numbers 0
showcolletters Whether or not to output the spreadsheet’s column letters. If true (1), the column letters will be marked up as <th> elements. 0
headers If true (1) the first row in the resultset will be marked up as <th> elements. Not applicable if showcolletters is true. 1
tableclass The xHTML class name to apply to the table. unset
oddclass The xHTML class name to apply to every odd <tr> element in the resultset. unset
evenclass The xHTML class name to apply to every even <tr> element in the resultset. unset
cachedir The name of the cache directory located in the files directory. This attribute only needs to be set if you choose a directory name other than ‘cache’. cache

About this plugin

This Textpattern plugin incorporates the excellent PHP Excel Reader class, originally written by Vadim Tkachenko and enhanced by Matt Kruse and Matt Roxburgh. Developed into a Textpattern plugin by Russell Brown.

Article Request Count:
Initially released:
19 April 2010
Posted here:
19 Apr 2010

You know you want to visit the Archives.
Published with Textpattern