DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: Framework for TemplaVoila

Created:2010-02-18T17:33:18
Changed:2013-07-10T21:44:09
Classification:templavoila_framework
Description:The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ----
Keywords:forAdmins, forDevelopers, forIntermediates, forAdvanced
Author:Ron Hall of Busy Noggin, Inc
Email:templavoila@busynoggin.com
Info 4:
Language:en

img-1 img-2 EXT: Framework for TemplaVoila - templavoila_framework

EXT: Framework for TemplaVoila

Extension Key: templavoila_framework

Language: en

Keywords: forAdmins, forDevelopers, forIntermediates, forAdvanced

Copyright 2010, Ron Hall of Busy Noggin, Inc, <templavoila@busynoggin.com>

Extension Development: Web-Empowered Church, < devteam@webempoweredchurch.org >

http://templavoila.busynoggin.com/

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.org

Table of Contents

EXT: Framework for TemplaVoila 1

`Introduction 3 <#__RefHeading__781_875286620>`_

What does it do? 3

Installation 3

Known Problems 3

To-Do List 3

Changelog 3

Introduction

What does it do?

This is the implementation of the Framework for TemplaVoila as a TYPO3 extension.

At its heart, this framework is a workflow supported by a code base and set of best practices to produce visually-varied sites quickly and consistently using TemplaVoila. Providing the code for the framework as an extension means:

Sites running on the extension version of the framework can receive future updates by updating the extension through the extension manager.

The framework can be brought into brand new TYPO3 installations or existing installations. It is no longer essential to start new sites with the Busy Noggin QuickSite.

Skins for the framework can now be packaged and distributed as extensions.

Skins can be easily managed with a new point and click interface

Instructions on using the framework and developing web site skins can be found at http://templavoila.busynoggin.com.

Installation

The Busy Noggin QuickSite is a ready-to-go installation of TYPO3 running the Templavoila Framework extension. You can find it at http://templavoila.busynoggin.com/.

The WEC Starter package also runs the framework and is available at http://webempoweredchurch.org/services/starter-package/. This package includes several extensions and five skins.

Installing in a TYPO3 Dummy Installation

There are instructions for installing the extension into a TYPO3 Dummy Package at http://templavoila.busynoggin.com/index.php?id=141

Installing into an Existing TYPO3 Installation

Currently we only recommend using the extension in a new TYPO3 install. This means installing the extension in a TYPO3 Dummy Package or using a ready-to-package from Busy Noggin or WEC.

There are many considerations when trying to convert an existing web site to the framework. The issues revolve around converting the content to the new data structures, properly accommodating for existing FCEs, converting previous DSs to the new TemplaVoila static data structures and more. If such conversions are attempted, they should only be done on a copy of the site and by a developer well versed in TemplaVoila and the TemplaVoila Framework.

Known Problems

The “Framework for TemplaVoila” extension conflicts with the TIMTAB blog extension if TIMTAB is loaded first. This is due to TIMTAB's initialization of backend classes before an XCLASS from the “Framework for TemplaVoila” is registered. If this happens you can uninstall TIMTAB and then reinstall TIMTAB. This will cause it to load after the framework.

To-Do List

Add documentation for installation, usage, and skin development.

Changelog

The following is a high level overview of changes in each release. For a full list of changes, please see the Changelog file within the extension.

1.2.7

Version

1.2.7

Changes

Minor updates for TYPO3 compatibility.

!!! This release lays the groundwork for TemplaVoila Framework 2.0, which will require TYPO3 6.0+. See https://github.com/busynoggin/templavoila_framework for a preview !!!

1.2.6

Version

1.2.6

Changes

Fix issues with duplicate Template Object imports in new Extension Manager (TYPO3 4.6+)

1.2.5

Version

1.2.5

Changes

Updated jQuery to version 1.7.2.

((Unknown Property))

Version

Changes

Fixed typo in TS definition of Plain Image FCE.

1.2.4

Version

1.2.4

Changes

Fixed bug with preCodeFeature and postCodeFeature not working.

((Unknown Property))

Version

Changes

Changed default on Plain Image FCE to be display:block.

1.2.3

Version

1.2.3

Changes

Temporarily disabled TemplaVoila's renderUnmapped setting to avoid page titles and other element showing up unexpectedly.

1.2.2

Version

1.2.2

Changes

Switched several TS settings to use references instead of copies.

((Unknown Property))

Version

Changes

Use TemplaVoila's setting to disable processing of unmapped content areas

(ex. Generated Content should not be processed for templates that do not use it)

1.2.1

Version

1.2.1

Changes

Added separate backend stylesheet for TYPO3 4.3

((Unknown Property))

Version

Changes

Fixed minor CSS issue with flags in TV page module.

1.2.0

Version

1.2.0

Changes

!!! TemplaVoila 1.5 and greater is now required. !!!

((Unknown Property))

Version

Changes

TV Framework Core TypoScript is now included before Skin TypoScript. Skin behavior does not change, but overriding the Core or overriding Skin objects from a TypoScript Template is now made easier by simply rewriting the original object.

((Unknown Property))

Version

Changes

Updated backend styling to match TemplaVoila and TYPO3 4.4.

((Unknown Property))

Version

Changes

Added distribution class (.oneThird, .oneHalf, etc) for modules and columns.

((Unknown Property))

Version

Changes

Added .plainImage and .plainImageLink classes to Plain Image FCE.

((Unknown Property))

Version

Changes

Fixed bug with sorting of skins in backend skin selector.

((Unknown Property))

Version

Changes

Added localization to tab names, content element headers, and data structure names.

((Unknown Property))

Version

Changes

Fixed several bugs with TemplaVoila 1.5 compatibility.

1.1.0

Version

1.1.0

Changes

Added feature for setting moduleTitleTag, allowing skin developer to specify what tag is used in module headers (defaults to h3)

((Unknown Property))

Version

Changes

Fixed bug with unframed modules interfering with equal height module calculations.

((Unknown Property))

Version

Changes

Fixed bug with missing classes on 3 and 4 column groups.

((Unknown Property))

Version

Changes

Added Spanish and Dutch localization for the backend.

1.0.4

Version

1.0.4

Changes

Fixed bug that caused Skin TypoScript to be included before Static TypoScript from Extensions.

1.0.3

Version

1.0.3

Changes

Changed filename for jQuery library to reflect current version and avoid caching problems.

((Unknown Property))

Version

Changes

Added TypoScript constant (enableJQuery = 1) to handle loading of jQuery and related Javascript. This constant is enabled by default.

((Unknown Property))

Version

Changes

Switched jQuery include to use includeJSLibs rather than includeJS.

((Unknown Property))

Version

Changes

Added support for TYPO3 4.4, using a hook rather than XCLASS.

1.0.2

Version

1.0.2

Changes

Removed TypoScript that unset the page TS object before the extension defines a new one. This avoids issues with extensions that write directly to the page object from a static template.

((Unknown Property))

Version

Changes

Adjusted backend CSS so that move icon appears for content elements in TemplaVoila Page Module.

((Unknown Property))

Version

Changes

Fixed bug where TypoScript from the framework was loaded even when no skin was selected.

1.0.1

Version

1.0.1

Changes

Updated default skin path for better TemplaVoila compatibility.

((Unknown Property))

Version

Changes

Fixed PHP error when using the Link Wizard for Site Constants.

((Unknown Property))

Version

Changes

Set jQuery.noConflict() by default.

1.0.0

Version

1.0.0

Changes

Initial release.

img-2 4