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: skin_grey_2

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed by:Tapio Markula
Changed:2008-10-22T20:22:39
Author:Tapio Markula
Email:tapio.markula@atwebteam.com
Info 3:
Info 4:

EXT: skin_grey_2

Extension Key: skin_grey_2

Copyright 2000-2005,Tapio Markula, < tapio.markula@atwebteam.com >

Additional authors: Lasse Nørby

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.com

Table of Contents

EXT: skin_grey_2 1

Introduction 1

What does it do? 1

History 1

Requirements and suggested extensions 2

Other authors 2

Screenshots 3

Configuration 4

Known problems 9

List of relation to other plugins: 9

To-Do list 9

Changelog 10

Credits 10

Introduction

What does it do?

This is an alternative skin for Typo3 3.8.x and Typo 4.0.x . Typo3 logo is for Typo3 4.0.x.

If you want more consistent layout for Typo3 3.8.x copy from the ' /skin_grey_2/' folder 'loginlogo_transp.gif' to /gfx/ folders of Typo3 3.8.x.

History

This skin base on 'skin_ grey' of Lasse Nørby. Most icons are from skin_grey skin but I have added some new icons, which I have personally done or taken from the 't3skin' for Typo3 4.0. As default this skin use module icons from t3skin. I added es an enable option the possibility to use original module icons of Lasse' s skin_grey or Windows XP style module icons. I have made them tiny changes in order to get consistent image sizes and using the new Typo3 logo, which came with version 4.0.

Now taken account also Lasse's another skin ( 'modern_skin' ) and use CSS and icons of that skin with some minor modifications.

The possibility to use horizontal collapse/expand for page/file navigation tree has been taken from 'skingreyman' of Michiel Roos .

Peter Klein have done the basic scripts for the new top menu for module selection, which I have made fitting for this skin. The new top menu is a new option in addition of existing alternatives, for example alternative for 'Left menu frame (default)' . It can be normally selected from 'User > Setup' (concerning Typo3 4.2.0 and newer the alternative can be used with the interface option 'Traditional backend' ).

Requirements and suggested extensions

This plugin is for Typo3 3.8.x – 4.0.x.

Many features of 'tm_contentaccess' have proper layout using skin_grey_2. With tm_contentaccess and skin_grey_2 you can get new layout for the classic page module and TemplaVoila page module.

If somebody installs skin_grey_2, that doesn't prevent using other skins, if the plugin 'kb_skinselect' has been installed. Kb_skinselect changes CSS files and icons. It has some problems, which has explained later in this document.

Other authors

Other authors have done following implementations:

  • Lasse Nørby – original CSS-files, basic icons and most background images.
  • Peter Klein – alternative top menu (implemented in tm_shared_lib).
  • Michiel Roos – collapse/expand functionality (implemented in tm_shared_lib).
  • Bernhard Kraft – some code for 'User > Setup' module (implemented in tm_shared_lib).
  • Georg Ringer – alternative CSS for login screen.

Skin_grey_2 is basically just a skin but it is possible to add for it some extra functionalities, for example new menu type for selecting modules, configuration through User > Setup.

Note . Starting from version 1.1.2 all special implementations need the 'tm_shared_lib' plugin. In previous versions many functionalities were included to skin_grey_2 directly but because many features were common with the plugin tm_contentaccess, it was reasonable to create a shared plugin. Many configurations, which are described in this manual, don't work without tm_shared_lib installed.

Screenshots

Skin_grey_2 works best with 'tm_ contentaccess', which gives for you additional layout control and possibility to create“ *Typo3 Lite*'. Limited 'Columns' view resembles the view of 'TemplaVoila' .

img-1

I have made for tm_contentaccess some skin-specific images for skin_grey_2. Images are in the folder '/res/extra-icons/' of tm_contentaccess (also '/fe-icons/' has one skin-specific icon).

I have made almost full covering button set. Many record types use old-fashioned icons, but I have modified alternative icons for required record types in order to get more consistent icon sets. Because old-style icons relate only records, which can be modified only admin users, I'm not going to make modern icons for those records (for example 'Website language ' and 'Countries' ). Some default plugins, which are shipped with Typo3 3.8.1, don't have new icons because it is not in overall possible to take account all plugins and it is not necessary to install all shipped plugins.

Configuration

This skin has some installation level configurationusing enable options. You can use ' enable.TinyMCEStyles' also for other editors but you must edit related CSS-files, ' TinyMCEStyles*.css'. These files have today partial support for the 'htmlarea' plugin.

Many features can be set by using personal user setup options, which have defined using the module User> Setup (entire usage of personal user setupcan be disabled from enable optionsof the plugin).

If you want to change module icons, I have some ready made alternatives. For own module icons I added ' enable.ModuleIconSetPath' and corresponding personal user setup. Thepath is relative to the path of this extension and it should be set without forward slash (/) to the end, for example '../../../fileadmin/my_moduleicons' .

You can also use your own CSS-file for the skin using 'enable.styleSheetFile_post' or corresponding personal user setup. The path is relative to the path of this extension, for example '../../../fileadmin/my_post_css.css' .

You can set also the height of module icons for new icon sets. Because of technical reasons height and width of minus/plus bullets is fixed in the left frame menu.

Using skin_grey_2 it is possibleto add some extra configuration for 'tm_contentaccess' , which has been explained in the manual for tm_contentaccess.

I made for 'mod.skin_grey_2' as if module configuration. Even if skin_grey_2 doesn't have a backend module, it has settings, which relate with 'Setup > User' module. Using mod.skin_grey_2 for TS Config for users/user groups administrators can override enable features options and set default values or override personal user setup options (default values mean default values in default settings in enable options or personal setup if enable options don't have certain option). In addition it has some completely own control options.

disableUserSetupSkinChanges

Property

disableUserSetupSkinChanges

Datatype

boolean/ string

Description

Disables user setup options for changing skin-related basic properties.

Set either boolean value 0/1 or comma separated list of values/fields, which should disable. Possiblevalues are: skin, moduleiconset, moduleiconsetpath, moduleiconsize, usepngmoduleimages, usepngfix, stylesheetfile_post

If disabled and TS Config for users/user groups has been set for disabled options, values in TS Config for users/ user groups has been set as personal user settings.

Note that for kb_skinselect is one option (skin), when it is also possibility to disable that plugin for some users without need of deinstall the plugin.

Default

maxSubItems

Property

maxSubItems

Datatype

integer

Description

Quantity of maximum sub-menu modules for the new top menu in one row. If the quantity has been reached, for rest of the sub-modules button has been set new main module links and main modules has been listed 1, 2, 3 etc., for example 'Tools 1, Tools 2, Tools 3'.

Default

6

subLabelLenght

Property

subLabelLenght

Datatype

integer

Description

Crop the label for sub-module labels in the new top menu. '0' means no cropping. Integer means that if the label is longer than the value, the label will be cropped and three dots added. Use just positive integer values!

Default

0

onClick

Property

onClick

Datatype

boolean

Description

Mode of the new top menu. The top menu works either with mouse movement (hover-mode) or clicking the mouse (two onclick-modes)

0 = hover mode

1 = onclick with low toolbar

2 = onclick with higher toolbar

Default

1

defaultMainModule

Property

defaultMainModule

Datatype

string

Description

Module, which sub-modules have been shown as default in the new top menu.

Default

web

saveSubModuleInfo

Property

saveSubModuleInfo

Datatype

boolean

Description

Saves automatic the last used sub-module.

The same option is available also as override option. Look at from that setting more details.

Default

0

saveModuleInfo

Property

saveModuleInfo

Datatype

boolean

Description

Save active main module tab as new default module. Overrides 'Default main module' setting.

The same option is available also as override option.

Default

leftOffset

Property

leftOffset

Datatype

integer

Description

Left offset for the new top menu. It helps to position sub-module links nearer the main module links. Left offset depends on situation and if that values has been changed, users just need to test, which is the best value.

Default

50

styleSheetFile

Property

styleSheetFile

Datatype

string

Description

Style sheet makes possible to change the used style sheet for the new top menu. Note. The menu has hover mode and two modes and two onclick modes.

Default

ModuleIconSet

Property

ModuleIconSet

Datatype

string

Description

Selection from predefined module icon sets. If set and ModuleIconSetPath has not set, ModuleIconSize ignored.

Default

ModuleIconSetPath

Property

ModuleIconSetPath

Datatype

string

Description

Path for own module icons

Default

ModuleIconSize

Property

ModuleIconSize

Datatype

integer

Description

Meaningful only if ModuleIconSetPath has been set. If predefined icon sets has been set, module icon sizes has been set automatic correct and this values is ignored.

Default

16

UsePNGModuleImages

Property

UsePNGModuleImages

Datatype

boolean

Description

Possibility to use PNG images for own module icons. Set only in the case, you use PNG module icons.

Default

0

UsePNGFix

Property

UsePNGFix

Datatype

boolean

Description

Sets PNG transparency fix for MS IE. Meaningful only for PNG-images.

This option doesn't have corresponding feature enable option.

Default

0

styleSheetFile_post

Property

styleSheetFile_post

Datatype

string

Description

Sets a style sheetfor the BE interface. Because also other style sheets have been used, doesn't reset all style sheets.

Default

disableAllowCollapseExpandNavFrame

Property

disableAllowCollapseExpandNavFrame

Datatype

boolean

Description

Allows/disables visual effects of enable.allowCollapseExpandNavFrame.

Doesn't normally override corresponding option in personal setup but just sets default value for personal user setup. Used if exits and personal working mode settings disabled.

Default

0

hideWorkspaceselector

Property

hideWorkspaceselector

Datatype

boolean

Description

Hides workspace selector from the shortcut frame. No setup using User > Setup.

Default

0

Notes.

  • If 'enable.ownCSSforUsers' is not checked, some or all of these settings might not work.
  • If 'styleSheetFile_post' has beenredefined, it is necessary to save the record twice.
  • Transparency fix for MS IE needs DirectX installed. Otherwiseimages can't be seen. The transparency fix slow a little bit down downloading speed, because images must render several times. PNG images are reasonable only for browsers, which support them properly.
  • 'disableAllowCollapseExpandNavFrame' simple hides expand/collapse buttons and they can be enabled using CSS. Needed functionality can be controlled only installation level.

Skin_grey_2 fixes also 'setup.override' optionswith a new option to disable all user settings (except personal settings and the language setting all values will be set as default):

disableUserSetup

Property

disableUserSetup

Datatype

string

Description

Disables and resets personal user setup options. Values base on the used names in fields, which have been mentioned in user setup but all names are in lowercase.

The string is comma separated list of values. Possible values for default options are: simulateuser, lang, condensedmode, nomenumode, taskcenter, thumbnailsbydefault, helptext, titlelen, copylevels, recursivedelete, edit_widedocument, edit_rte, edit_docmoduleupload, edit_showfieldhelp, disablecmlayers, realname, email, emailmeatlogin, password1, password2 (concerning the last two in the list it is enough to setup either password1 or password2). In addition of default values plugins might have extra values.

Default

startPage

Property

startPage

Datatype

string

Description

Starting page after log in to the BE. That can be some page in front end.

Default

defaultMainModule

Property

defaultMainModule

Datatype

string

Description

Default main module, which is visible when starting Typo3.

Default

startModule

Property

startModule

Datatype

string

Description

Starting module. Note in previous versions of tm_shared_lib this option was 'startingModule' .

Default

saveSubModuleInfo

Property

saveSubModuleInfo

Datatype

boolean

Description

Saves automatic the last used sub-module.

Note that this setting setting works, if the 'startPage' has not been defined or it has been defined as empty, when default starting page has been used. The default starting has redirect JavaScript function to the desired starting module.

Default

0

saveMainModuleInfo

Property

saveMainModuleInfo

Datatype

boolean

Description

Saves in the last active main module as new default module.

The same option also available in module configuration

Default

allowAdminFunctions

Property

allowAdminFunctions

Datatype

boolean

Description

Allows for non-admin users admin functions to clear BE and FE cache (needs either 'enable.newTopmenu' or ' enable.shortcutframe_ontop' enabled)

Default

0

Added also to mod.SHARED following options:

startID

Property

startID

Datatype

integer

Description

Starting page (field 'uid' ) for page module. Sets default starting page for modules, which belongs under the main module 'Web'.

Default

saveUID

Property

saveUID

Datatype

boolean

Description

Use cookies order to store start page (field 'uid') for every sub modules, which belongs to the main module 'Web'. Takes precedence over 'startID' .

Default

0

resetCookies

Property

resetCookies

Datatype

boolean

Description

When used cookies for saveUID information has been saved also into database. With this option you can reset cookies, when you log into the backend of Typo3 or reload the entire frameset. At that ways same cookies have been used with different browsers and even with different computers.

Saves into database also information about the last used main and sub module.

Default

0

Known problems

  • Some enable options use XCLASS-implementations, whichcause conflicts with other plugins, which do the same for the same classes. In some of plugins made by Tapio Markula possible conflicts has been handled and there should not be conflicts with those plugins.
  • If used in User > Setup 'startInTaskCenter' I don't get highlight working for default top menu and left menu frame, when Typo3 has been opened. Highlight works however with the new top menu.

List of relation to other plugins:

  • tm_shared_lib – most special functionalities needs this plugin. I has many extended files, which are common with my other plugins.
  • skingreyman should work ok with Firefox but problems with MS IE. In general several skins should not be active at the same time because of CSS-conflicts.If you want to give possibility users to select skins, install 'kb_skinselect'.
  • kb_skinselect – should be compatible but has some problems. Kb_skinselect can't handle properly alternative stylesheets, which skin_grey_2 offers. It uses for skin_grey_2 always default CSS- files. If tm_shared_lib has been installed and user setup has been allowed, label for selecting new skin has been redefined. Selecting skins has been put among other BE interface layout features after other settings. Note that if the skin has been changed, module icon set for skin_grey_2 should be set as 'standard' and nobody should not create own module icons.
  • tm_contentaccess – works best with it. If you update skin_grey_2, check if there is new version of tm_contentaccess available.
  • tm_tvpagemodule – like tm_contentaccess this plugin needs skin_grey_2 to be installed in order to get desired layout.
  • tinyrte – the layout of this editor fits best with this plugin. I have added an extra style sheet for TinyMCE,TinyMCEStyles.css.You can alter that file. If you do so, take copy of the file because you loose changes in the next update. TinyMCEStyles enabled the layout of tabs in the Typo3 interface is everywhere Windows XP style like in the pop-up-windows of TinyMCE.
  • extdeveval - needs some changes into related plugin (tm_shared_lib). If the tabbed menu for selecting backend modules has been used comment in the ext_localconf.php the following line:#$T YPO3_CONF_VARS['SC_OPTIONS']['typo3/alt_topmenu_dummy.php']['fetc hContentTopmenu'][] = 'EXT:extdeveval/class.tx_extdeveval_fetchConte ntTopMenu.php:tx_extdeveval_altTopMenuDummy';
  • chloginskin – added functionality without example stylesheets.
  • modern_skin – added stylesheets and icons, which can be used as alternative of default CSS and icons.
  • t3skin – added icon set and possibility to link to stylesheets of this skin selecting as CSS theme 't3skin'

To-Do list

Nothing at this moment.

Changelog

  • Support of newer TinyMCE styles tab images.
  • Checked against Typo3 4.2.1.
  • Icon sets 't3skin' and 'modern_skin' icon sets has been moved into separate extension ('skin_grey_iconsets').
  • Added functionality of 'chloginskin' without example stylesheets. Look at the manual of chloginskin (this plugin doesn't offer any example stylesheets and related images).
  • Added possibility to use icons of 't3skin' (some icons changed/added).
  • Made compatible with Typo3 4.2.0RC1 and CSS theme 'modern_skin' correspond now modern skin ver. 1.1.4 (new icon set for module menu).
  • Changed handling of own CSS files.
  • Added possibility to switch basic icon sets. One set resemble much the default skin for Typo3 4.1.x.
  • Reorganized CSS-files in order to make possible using tm_shared_lib select for login screen own CSS-file, when users want to select user level stylesheet theme (original, fullgray, t3skin).
  • Changed 'setup.override.startingModule' to 'setup.override.startModule'.
  • Option disableUserSetupSkinWorkingModeChanges has moved from skin settings into mod.SHARED.disableUserSetupSkinWorkingModeChanges and the issue has been explained int the manual for tm_shared_lib.
  • Moved all XCLASSes into tm_shared_lib plugin. Extra features of this skin needs that plugin.
  • Added better support for the htmlarea plugin.
  • Added possibility to store last used page, active main and submodule into database and reset cookies, when login into the backend of Typo3 or when the entire frameset has been reloaded.
  • Added possibility to save last used page and related page in page tree into cookies.
  • Added possibility to save active sub module as default starting module into cookies.
  • Added possibility to save active main module tab as new default module. Overrides 'Default main module' setting.
  • Added setup.override.allowAdminFunctions option.
  • Made new top menu and for it configuration options.
  • Made compatible with plugin pmktextarea.
  • Added personal user setup options in order to configure the skin. Adds also proper control for default user setup.
  • Added optional PNG transparencyfix for MS IE.
  • Added possibilityto use collapse/expand links for page and folder trees (made by Michiel Roos ).
  • Added possibility to set CSS for the BE using TS Configfor CSS users/ usergroups (works however partial).
  • Added ver. 0.9 buttons, which are not anymore used into reserve folder( '/res/update_button_set' ). New style folder icons as default and they don't have anymore a reserve folder.
  • Added localization for record types 'Backend user', 'Backend usergroup' and 'Filemount'. New style folder icons into own folder (older style folder icons back).
  • Added possibility to set path for own module icons and CSS-file for the skin.
  • Added full set of tree icons (the same as in the default skin for Typo3 3.8.1) and in practicecompleteset of content type icons (obsolete content types are ignored – they are not listed in the drop downmenu for selecting available content element types). Also added alternative icons for record type icons as I mentioned in the to dolist.
  • Added possibility to change module icons using enable options.
  • Added this manual.
  • Added stylesheet for tinyrte.
  • Made CSS work better with different WYSIWYG editor (takes account the default editor for Typo3 3.8.1, HTMLAREA (rtehtmlarea) and TinyMCE.

Credits

Special thank's for Peter Klein for the top menu and Stefan Galinski < Stefan.Galinski@frm2.tum.de > helping finding bugs in this and related plugins.

skin_grey_2 - 10