ZEN WIREFRAME v3.5 README The extensions in the TYPO3 extension repository are free to use. Although they are reviewed for possible security issues, their installation might cause problems in your TYPO3 installation or not work as expected. Neither the respective authors, the reviewers, nor the providers of this website or TYPO3 take any responsibility for problems resulting from the use of code provided by this repository. The XHTML files contained in Zen Wireframe and Typoscript are distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. If you find a bug or issues, please report them either at our forum, contact form or please send an email. As of Zen Wireframe 3.0, the Core HTML/CSS files used for template prototyping and creation use introduces the 960 CSS Grid System framework and Superfish jQuery menu. Please be sure to visit these sites for more information. 960 CSS Grid System http://960.gs Superfish jQuery menu http://users.tpg.com.au/j_birch/plugins/superfish/ Core HTML Files: zwire/1column.html zwire/2column-style1.html zwire/2column-style2.html zwire/2column-style3.html zwire/3column.html Core CSS Files: zwire/css/960.css zwire/css/gmenu.css zwire/css/ie.css zwire/css/superfish.css zwire/css/text.css zwire/css/zwire.css The 960 Grid System is an effort to streamline web development workflow by providing commonly used dimensions, based on a width of 960 pixels. The purpose of the system is ideally suited to rapid prototyping, but it would work equally well when integrated into a production environment. For more information, demos and templates, please visit http://960.gs Superfish is an enhanced Suckerfish-style menu jQuery plugin that takes an existing pure CSS drop-down menu and adds the following much-sought-after enhancements: * Suckerfish-style hover support for IE6. * Timed delay on mouseout * Animation of sub-menu (fade-in by default). * Keyboard accessibility. * Supports the hoverIntent plugin. ---------------------------------------------------------------------------------- ZEN WIREFRAME v3.5 INSTALLATION DO NOT ATTEMPT TO UPGRADE an older or existing version of Zen Wireframe with a newer .t3d version and associated HTML and CSS files. Doing so will destroy your existing installation and any customizations to your HTML/CSS. The supplied .t3d import file and related HTML/CSS files are to be used for new TYPO3 installations and projects only. Do not attempt to install the .t3d import file if you have ever created or deleted pages on an existing TYPO3 installation! Please be sure you read the install.txt and zwire-extensions.txt before proceeding. Failure to do so may result in many hours of trial and error and unhappy customers. If you are running an older version of Zen Wireframe and wish to upgrade TypoScript and extension templates, please scroll down to the section titled UPGRADING ZEN WIREFRAME TYPO3 EXTENSION TEMPLATES MANUALLY. If you are new to TYPO3 please be sure to check out these basic TYPO3 Pre Flight Checklist Tutorial before beginning and for additonal configuration, TypoScript and CSS design tips. http://www.mediatech.net/typo3_tutorials.html ---------------------------------------------------------------------------------- IMPORTANT TIPS! PLEASE READ BEFORE INSTALLING! Before installing extensions, go to Install Tool > 2: Database Analyser and select "Update required tables COMPARE". Update any database tables and fields shown at http://www.your-domain.net/typo3/install/index.php. Many extension templates and extension flexforms need to be modified to include real details about you, your client, business or organization such as email address, company/organization name and other important criteria. ZEN WIREFRAME v3.5 contains documentation for each demo page covering Typoscript, HTML and CSS used for most extensions. Please be sure to refer to the demo documentation linked to each example page for additional setup and configuration information. ---------------------------------------------------------------------------------- TYPO3 USERS AND USERGROUPS Zen Wireframe v3.5 comes configured for (optional) Frontend and Backend users and usergroups for learning, demonstration and organizational or company driven websites requiring advanced user access and management. Please change the default usernames and/or passwords immediately if you are new to TYPO3 and using Zen Wireframe for a production site! Failure to do so may put your installation at risk if is accessible to the public! Only website users which are members of the selected usergroup will be able to view the page and/or content of that page when they are logged in. The special option 'Hide at login' means the page will not be visible for website users that are logged in. Likewise "Show at login" will make the page visible for any logged in frontend user. FRONTEND USERS AND USERGROUPS There are 2 Frontend users and 6 Frontend demo user groups stored in the sys folder fe users (page id 4). Please review and understand how default Frontend users and usergroups and their coresponding id values are configured in each Extension TypoScript template before using them. By default, Frontend user accounts that are created via Frontend user Registration form and assigned to the Frontend usergroup UnconfirmedMember until they have opted in via a welcome email confirmation. Once opted in, Frontend users are automatically assigned to the user group "ConfirmedMember". The usergroup "ConfirmedMember" has access to the forum and other sections of the web site that have Access restrictions. FRONTEND USERS: admin - id = 2. The Frontend usergroup "admin" has been assigned to Frontend usergroup "Admin". Any new Frontend user assigned to the Frontend usergroup "Admin" will also have access to Admin, Editor, Moderator, Customer and ConfirmedMember usergroup restricted pages and content. admin default passowrd: 123456 (please change immediatly after installation) editor - id = 1. The Frontend usergroup "editor" has been assigned to Frontend usergroup "Editor". Any new Frontend user assigned to the Frontend usergroup "Editor" will also have access to Editor, Moderator, Customer and ConfirmedMember usergroup restricted pages and content. editer default passowrd: 123456 (please change immediatly after installation) FRONTEND USERGROUPS: Frontend usergroups can be assigned to Frontend subgroups however, to keep things simple, Frontend usergroups are only being used to restrict pages, pages content and extension access for the following usergroups. Admin - id = 1. Has access to all TYPO3 Calendar editing features and forum administrator. Editor - id = 2. Has access to all TYPO3 Calendar editing features. Moderator - id = 3. Granted access as forum moderator. Customer - id = 4. Assigned to no subgroups and used for ecommerce accounts. UnconfirmedMember - id = 5. Has no access to restricted site content. ConfirmedMember - id = 6. Has limited public access to forum, shopping cart and member login page. BACKEND USERS AND USERGROUPS There is 1 additional Backend user named "editor" and 2 Backend usergroups named "Admin" and "Editor" stored in the Root of the Page Tree (id 0). You will need to manually assign your default TYPO3 admin user to the Backend usergroup "Admin" after installation to use the TSconfig Options associated with the "Admin" usergroup. editor default passowrd: 123456 (please change immediatly after installation) The Backend user "editor" is linked to the Backend usergroup "Editor" and associated TSconfig Options and Access Lists for Page type, Tables, Module and Allowed excludefields. Please review these before using to get a better understanding of how to manipulate TypoScript TSconfig restrictions and setting for the Backend user "editor". BACKEND USERS: admin - id = 1 editor - id = 2 BACKEND USERGROUPS: Admin - id = 2 Editor - id = 1 2 TypoScript configurations for the Frontend user EditPanel for Backend usergroups Admin and Editor in the root Template Zen Wireframe v3.5 have been added to control what EditPanel and EditPanelPage options Backend user groups 1 (Admin) and 2 (Editor). You can disable these of course and enable the use of the default admPanel feature by uncommenting #page.config.admPanel = 1. # Frontend User EditPanel Settings ###################################### #page.config.admPanel = 1 # Options: toolbar,new,edit,hide,move,delete tt_content.stdWrap.editPanel.allow = new,edit,hide,move,delete styles.content.editPanelPage { 10 = EDITPANEL 10 { allow = toolbar } } page.10 < styles.content.editPanelPage The Frontend users "admin" and "editor" can be connected to Backend users admin and editor via TYPO3 Extension BE-login simulation for fe-users ( simulatebe ). This is very useful for allowing full (admin) and restricted (editor) Backend editing rights to site administrators you don't want accessing the TYPO3 administrative Backend. To see how this works please refer to the extension manual. http://typo3.org/extensions/repository/view/simulatebe/current/ ---------------------------------------------------------------------------------- T3D IMPORT FILE The supplied .t3d import file is to be used for new TYPO3 installations only. Do not attempt to install the supplied .t3d import file if you have ever created or deleted pages on a TYPO3 installation! Before installing extensions, go to Install Tool > 2: Database Analyser and select "Update required tables COMPARE". Update any database tables and fields shown at http://www.your-domain.net/typo3/install/index.php. Many extension templates and extension flexforms need to be modified to include real details about you, your client, business or organization such as email address, company/organization name and other important criteria. ZEN WIREFRAME v3.5 contains documentation for each demo page covering Typoscript, HTML and CSS used for most extensions. Please be sure to refer to the demo documentation linked to each example page for additional setup and configuration information. ---------------------------------------------------------------------------------- UPGRADING ZEN WIREFRAME TYPO3 EXTENSION TEMPLATES MANUALLY If you wish to manually update extension TypoScript templates and CSS/HTML files as new extension versions are released with changes, you can copy these changes from the typo3conf/ext/extension directory over to the Zen Wireframe fileadmin/templates/zwire/ext directory. you may also need to manually update existing and new TypoScript configuration if necessary. DO NOT perform these updates directly to your live production site unless you are absolutely sure about what you are doing and have made a full backup of all files and your database! Be aware that any TYPO3 extension you upgrade in the future may require you to update related HTML templates stored in zwire/ext should the extension author makes changes to templates used in the new version. If you have made customizations to your TYPO3 extension HTML/CSS templates, you can use a diff tool to carry over your customizations such as WinMerge for PC or FileMerge for Mac. http://winmerge.org http://the.taoofmac.com/space/apps/FileMerge Example for Frontend user Registration. Note: some extensions store their CSS in TypoScript setup.txt. HTML Template: Copy typo3conf/ext/sr_feuser_register/pi1/tx_srfeuserregister_pi1_css_tmpl.html INTO fileadmin/templates/zwire/ext/srfeuserregister_css.html CSS File: Copy typo3conf/ext/sr_feuser_register/static/css_styled/setup.txt INTO fileadmin/templates/zwire/css/ext/srfeuserregister.css If you require help or wish to save time, you can optionally request commercial support, training and/or development at support(at)mediatech.net. ---------------------------------------------------------------------------------- EXTENSION BUG REPORTS AND FEATURE DEVELOPMENT If you find a bug with an extension please submit all Bug Reports for the core of TYPO3 4.x at http://bugs.typo3.org/ If you wish to hire a developer to implement a new extension feature, Zen Wireframe contains direct links on each page to the extension author(s) website. You may also report any issues or share ideas to improve documentation by sending an email to support(at)mediatech.net Copyright (C) 2009 Gregory Remington. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". Visit http://www.gnu.org/copyleft/fdl.html Zen Wireframe Version 3.5 * Email: support(at)mediatech.net * Website: http://www.mediatech.net