Standardization
From TYPO3Wiki
| Teams Committees | This project/information is related to the Extension coordination team |
| List Projects | The Standardization for TYPO3 extensions-project list pages | See Current Project Members, Wishlist |
| you can help if you like! |
Contents |
|
Title: |
Standardization |
|
This document is published under the Open Content License The content is related to TYPO3 - a GNU/GPL CMS/Framework available from www.typo3.com |
The Standardization (Standardisation) is an ECT (Extension Coordination Team) project getting standards for the naming of TypoScript, CSS, PHP classes and almost everything. All extensions should be developed and named in the same way to make it easier for customers and programmers to use them. Even the naming of folders, template files and database table fields should follow a common way in all extensions.
Relations
Current Project Members
Proposals
You are free to add your proposals here.
CSS
TypoScript
example should be replaced by your names.
| Topic: | Property: | Data type: | Description: | Default: |
|---|---|---|---|---|
| date | exampleDate_stdWrap | ->stdWrap | stdWrap for example date Example: exampleDate_stdWrap.strftime = %d-%m-%Y %H:%M | |
| global markers | marks | array | key and value pairs of global markers Example: marks.MYMARKER = Hello, this is my marker. This will replace the marker ###MYMARKER### globally with this example text. A hook function 'addGlobalMarkers' should be available, too. |
File system nomenclature
| Description: | Naming: |
|---|---|
| File folder for FE users of extensions | fileadmin/feusers/FE account name/tx_extensionname/ |
| File folder for FE users images | fileadmin/feusers/FE account name/pics/ |
| File folder for FE users DAM files | fileadmin/feusers/FE account name/media/ |
| File folder for FE users DAM MP3 files | fileadmin/feusers/FE account name/media/mp3/ |
The benefit of this would be that an admin could easily find the folders of FE in the filesystem, copy and delete them. BE admins can use the fieadmin. FTP and SFTP could be used to transfer the data.
Standards
These are the recommended standards.
File system nomenclature
Image folder: uploads/pics File folder for extensions: uploads/tx_extensionname
Extension subfolders:
| folder name: | Description: |
|---|---|
| control | the code which controls the flow inside of the code |
| eid | code called by Ajax with eID parameter. |
| lib | library code. Usually no objects are created out of it. |
| hooks | hooks for other or this extension |
| marker | this deals with replacement of markers |
| model | the code which deals with access to the database tables |
| res/icons/fe | icons used in the FE |
| res/icons/be | icons used in the BE |
| res/icons/table | icons used for tables in BE |
| static | folder which contains the files constants.txt and setup.txt, maybe in subfolders |
| template | example templates for the extension |
| view | the code which is for the generation of the output |
Serious suggestions and wild ideas
These are ideas that may end up on the Wishlist. They are in the article (as opposed to the discussion tab) to put them in plain view.
- Create DTD's for things like flexforms . . .
- . . . Add 'validator' support to the 'extdeveval' extension, so you can validate your own flexforms and other things that have a DTD.
Categories: ECT | Project
