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: Readable name of your extension¶
Created: | 2010-02-18T17:33:18 |
---|---|
Changed: | 2012-01-18T12:07:57.060000000 |
Classification: | extensionkey |
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: | keywords comma-separated |
Author: | Author Name |
Email: | your@email.com |
Info 4: | |
Language: | en |
bnb Filesharing - bnbfilesharing
Bnb Filesharing¶
Extension Key: bnbfilesharing
Language: en,de
Keywords: filesharing, file, download, frontend, filemanager, extbase, fluid, ajax, intranet, exchange platform, groupware
Copyright 2011, Sönke Trunk, Catherine de Courten , <info@beans-n-bites.de>
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: Readable name of your extension 1
`Introduction 3 <#1.1.Introduction|outline>`_
`Users manual 4 <#1.2.Users%20manual|outline>`_
`Administration 5 <#1.3.Administration|outline>`_
`Configuration 6 <#1.4.Configuration|outline>`_
`Tutorial 7 <#1.5.Tutorial|outline>`_
`Known problems 8 <#1.6.Known%20problems|outline>`_
`To-Do list 9 <#1.7.To-Do%20list|outline>`_
`ChangeLog 10 <#1.8.ChangeLog|outline>`_
`Issues with Open Office documentation for TYPO3 12 <#2.1.Issues%20w ith%20Open%20Office%20documentation%20for%20TYPO3|outline>`_
HowTo: Update a manual to the new layout 13
HowTo: (alternative) Import the styles from another document 14
HowTo: Fix the Table Of Contents when a chapter is missing 14
Introduction¶
What does it do?¶
Frontendusers can exchange files via the frontend. They can create virtual folders, nested in any depth, and up- and download files. The folders are displayed in accordion-style on one page. The folders and files can be renamed and/or deleted. Permissions for all operations can be set, to everyone, a specific usergroup or the owner.
Screenshots¶
Users manual¶
Installation¶
System requirements: TYP3 4.5, Extbase 1.3.0, Fluid 1.3.0
Install the extension with the extension manager.
Create a new page and insert a content element of type “ General Plugin ”
Open the tab “ Plugin ” and choose the plugin “ bnbFilesharing ”.
Create a sysfolder. All records will be stored here.
Include the static template in your Typoscript setup.Switch to module “ Template ”, choose your root template and edit “The whole template record”. Change to tab “include” and select the static template “ bnbFilesharing ”.Please note: ” CSS Styled Content” must be included before“ bnbFilesharing” !
Create an extension template for the page, where you inserted the bnbFilesharing plugin in step 2. Configure at least the “ storagePid ” of the sysfolder you created in step 3:E.g. plugin.tx_bnbfilesharing.persistence.storagePid = 21
Please note: storagePid underGeneral Record Storage Pagedoes not work.
In this extension template you can configure further values differing from the default configuration in typo3conf/ext/bnbfilesharing/Conf iguration/TypoScript/constants.txt .
The extension should now be working.
7. If you want to use the extension on more than one page, e.g. to seperate different themes, repeat step 2 to 5. Don't forget to adjust the according storagePid.
Please note: If you use the extension on different pages, you can not bring together the uploaded files or created folders afterwards.
Frontend Login¶
Usually you would want to protect the bnbFilesharing tool for registered users. Use the TYPO3 frontend login and create frontend usergroups.
In the configuration for the bnbFilesharing extension you can set the rights to create, edit, rename, delete, upload and download files and folders, to every frontend user, a specific frontend usergroup or the owner. For details see “Configuration”.
Language Support¶
The bnbFilesharing extension supports languages. At the moment there are translations for labels, errormessages etc. in german and english (config.language = en/de). If you want to use more or other languages, you need to translate labels, errormessages etc. in Resources/Private/Language/locallang.xml.
If you want to create different records for each language, set CreateLocalRecords to 1 in your setup. bnbFilesharing will then automatically create records for each language. I.e. for each language you can upload a different file or name folders differently.
If CreateLocalRecords is set to 0, no localized records are generated. All localisations will show the same data records, if config.sys_language_mode is set to content_fallback in your Typoscript setup.
Configuration¶
Reference¶
storagePid¶
Property
storagePid
Data type
integer
Description
The uid of the sys-folder where the records will be stored.
Default
userGroupAllowCreateRootFolders¶
Property
userGroupAllowCreateRootFolders
Data type
string
Description
The ID of the usergroup which can create folders on the rootline (1. level) of the filesharing page.
all if everybody can create folders on the rootline.
Default
all
userGroupAllowCreateFolders¶
Property
userGroupAllowCreateFolders
Data type
string
Description
The ID of the usergroup which can create subfolders.
all if everybody can create subfolders.
owner if only the owner of the parentfolder can create subfolders.
Default
all
userGroupAllowEditFolders¶
Property
userGroupAllowEditFolders
Data type
string
Description
The ID of the usergroup which can edit foldernames.
all if everybody can edit foldernames.
owner if only the owner of the parentfolder can edit foldernames.
Default
all
userGroupAllowDeleteFolders¶
Property
userGroupAllowDeleteFolders
Data type
string
Description
The ID of the usergroup which can delete folders.
all if everybody can delete folders.
owner if only the owner of the folder can delete the folder.
Default
all
userGroupAllowEditFiles¶
Property
userGroupAllowEditFiles
Data type
string
Description
The ID of the usergroup which can edit filenames.
all if everybody can edit filenames.
owner if only the owner of the file can edit the filename.
Default
all
userGroupAllowDeleteFiles¶
Property
userGroupAllowDeleteFiles
Data type
string
Description
The ID of the usergroup which can delete files.
all if everybody can delete files.
owner if only the owner of the file can delete files.
Default
all
userGroupAllowUpload¶
Property
userGroupAllowUpload
Data type
string
Description
The ID of the usergroup which can upload files.
all if everybody can upload files.
owner if only the of owner of the parentfolder can upload files.
Default
all
userGroupAllowDownload¶
Property
userGroupAllowDownload
Data type
string
Description
The ID of the usergroup which can download files.
all if everybody can download files.
Default
all
allowedUploadFileTypes¶
Property
allowedUploadFileTypes
Data type
string
Description
Comma separated list of allowed filetypes, e.g. pdf, jpg.
all if every filetype is allowed.
Default
all
forbiddenUploadFileTypes¶
Property
forbiddenUploadFileTypes
Data type
string
Description
Comma separated list of forbidden filetypes.
Default
php, php3, php4, php5
loadjquery¶
Property
loadjquery
Data type
Boolean
Description
If set, JQuery is loaded. Set to 0 if JQuery is already loaded e.g. by another extension.
Default
1
loadFancybox¶
Property
loadFancybox
Data type
boolean
Description
If set, Fancybox is loaded. Set to 0 if Fancybox is already loaded e.g. by another extension.
Default
1
loadjqueryForm¶
Property
loadjqueryForm
Data type
boolean
Description
If set, JQuery Form is loaded. Set to 0 if JQuery Form is already loaded e.g. by another extension.
Default
1
createLocalRecords¶
Property
createLocalRecords
Data type
boolean
Description
If set, localization records are automatically created. Set to true, if you want different records for each language.
Default
1
orderFolderField¶
Property
orderFolderField
Data type
string
Description
The fieldname, folders are orderd by
Possible values: name , date
Default
name
orderFolderOrder¶
Property
orderFolderOrder
Data type
string
Description
Ascending or descending order of foldersPossible values: ASC , DESC
Default
ASC
orderFilesField¶
Property
orderFilesField
Data type
string
Description
The fieldname, files are orderd by
Possible values: name , date
Default
name
orderFilesOrder¶
Property
orderFilesOrder
Data type
string
Description
Ascending or descending order of filesPossible values: ASC , DESC
Default
ASC
maxUploadFilesize¶
Property
maxUploadFilesize
Data type
integer
Description
Max filesize in KB. If this value ist larger than
$TYPO3_CONF_VARS['BE']['maxFileSize'], this value will be ignored.
Default
1024
Known problems¶
If general typoscript constant config.prefixLocalAnchors is set, the dialogues with Fancybox won't show.