FileBrowser extends AbstractResourceBrowser
Browser for files. This is used when adding a FAL inline image with the 'add image' button in FormEngine.
Table of Contents
Constants
- IDENTIFIER = 'file'
Properties
- $backendViewFactory : BackendViewFactory
- $bparams : string
- Active with TYPO3 Element Browser: Contains the name of the form field for which this window opens - thus allows us to make references back to the main window in which the form is.
- $currentPage : int
- $displayThumbs : bool
- $expandFolder : string|null
- $extensionConfiguration : ExtensionConfiguration
- $fileExtensionFilter : FileExtensionFilter|null
- $filelist : FileList|null
- $iconFactory : IconFactory
- $identifier : string
- $moduleStorageIdentifier : string
- $pageRenderer : PageRenderer
- $request : ServerRequestInterface|null
- $resourceDisplayMatcher : Matcher|null
- $resourceSelectableMatcher : Matcher|null
- $searchDemand : FileSearchDemand|null
- $searchWord : string|null
- $selectedFolder : Folder|null
- $uriBuilder : UriBuilder
- $view : ViewInterface
- $viewMode : ViewMode|null
Methods
- __construct() : mixed
- getIdentifier() : string
- Returns the identifier for the browser
- getUrlParameters() : array<string|int, string>
- Provides an array or GET parameters for URL generation
- processSessionData() : array<int, array<string|int, mixed>|bool>
- Session data for this class can be set from outside with this method.
- render() : string
- setRequest() : void
- createUri() : string
- getBackendFavicon() : string
- Retrieves configured favicon for backend with fallback.
- getBackendUser() : BackendUserAuthentication
- getBodyTagAttributes() : array<string, string>
- getBodyTagParameters() : string
- getBParamDataAttributes() : array<string, string>
- Splits parts of $this->bparams and returns needed data attributes for the Javascript
- getLanguageService() : LanguageService
- getNormalizedParams() : NormalizedParams
- getRequest() : ServerRequestInterface
- getUriForFileName() : string
- Returns the uri of a relative reference, resolves the "EXT:" prefix (way of referring to files inside extensions) and checks that the file is inside the project root of the TYPO3 installation
- getViewModeButton() : ButtonInterface
- initialize() : void
- Loads additional JavaScript
- initSelectedFolder() : void
- initVariables() : void
- loadStylesheets() : void
- Load all registered stylesheets from $GLOBALS['TYPO3_CONF_VARS']['BE']['stylesheets']
- setUpBasicPageRendererForBackend() : void
- Sets mandatory parameters for the PageRenderer.
Constants
IDENTIFIER
public
mixed
IDENTIFIER
= 'file'
Properties
$backendViewFactory read-only
protected
BackendViewFactory
$backendViewFactory
$bparams
Active with TYPO3 Element Browser: Contains the name of the form field for which this window opens - thus allows us to make references back to the main window in which the form is.
protected
string
$bparams
= ''
Example value: "data[pages][39][bodytext]|||tt_content|"
or "data[tt_content][NEW3fba56fde763d][image]|||gif,jpg,jpeg,tif,bmp,pcx,tga,png,pdf,ai|"
Values:
0: form field name reference, eg. "data[tt_content][123][image]"
1: htmlArea RTE parameters: editorNo:contentTypo3Language
2: RTE config parameters: RTEtsConfigParams
3: allowed types. Eg. "tt_content" or "gif,jpg,jpeg,tif,bmp,pcx,tga,png,pdf,ai"
4: IRRE uniqueness: target level object-id to perform actions/checks on, eg. "data-4-pages-4-nav_icon-sys_file_reference" ("data-
$pArr = explode('|', $this->bparams); $formFieldName = $pArr[0]; $allowedTablesOrFileTypes = $pArr[3];
$currentPage
protected
int
$currentPage
= 1
$displayThumbs
protected
bool
$displayThumbs
= true
$expandFolder
protected
string|null
$expandFolder
= null
$extensionConfiguration read-only
protected
ExtensionConfiguration
$extensionConfiguration
$fileExtensionFilter
protected
FileExtensionFilter|null
$fileExtensionFilter
$filelist
protected
FileList|null
$filelist
= null
$iconFactory read-only
protected
IconFactory
$iconFactory
$identifier
protected
string
$identifier
= self::IDENTIFIER
$moduleStorageIdentifier
protected
string
$moduleStorageIdentifier
= 'media_management'
$pageRenderer read-only
protected
PageRenderer
$pageRenderer
$request
protected
ServerRequestInterface|null
$request
= null
$resourceDisplayMatcher
protected
Matcher|null
$resourceDisplayMatcher
= null
$resourceSelectableMatcher
protected
Matcher|null
$resourceSelectableMatcher
= null
$searchDemand
protected
FileSearchDemand|null
$searchDemand
= null
$searchWord
protected
string|null
$searchWord
= null
$selectedFolder
protected
Folder|null
$selectedFolder
= null
$uriBuilder read-only
protected
UriBuilder
$uriBuilder
$view
protected
ViewInterface
$view
$viewMode
protected
ViewMode|null
$viewMode
= null
Methods
__construct()
public
__construct(IconFactory $iconFactory, PageRenderer $pageRenderer, UriBuilder $uriBuilder, ExtensionConfiguration $extensionConfiguration, BackendViewFactory $backendViewFactory) : mixed
Parameters
- $iconFactory : IconFactory
- $pageRenderer : PageRenderer
- $uriBuilder : UriBuilder
- $extensionConfiguration : ExtensionConfiguration
- $backendViewFactory : BackendViewFactory
getIdentifier()
Returns the identifier for the browser
public
getIdentifier() : string
Return values
stringgetUrlParameters()
Provides an array or GET parameters for URL generation
public
getUrlParameters(array<string|int, mixed> $values) : array<string|int, string>
Parameters
- $values : array<string|int, mixed>
-
Array of values to include into the parameters
Return values
array<string|int, string> —Array of parameters which have to be added to URLs
processSessionData()
Session data for this class can be set from outside with this method.
public
processSessionData(array<string|int, mixed> $data) : array<int, array<string|int, mixed>|bool>
Parameters
- $data : array<string|int, mixed>
-
Session data array
Return values
array<int, array<string|int, mixed>|bool> —Session data and boolean which indicates that data needs to be stored in session because it's changed
render()
public
render() : string
Return values
string —HTML content
setRequest()
public
setRequest(ServerRequestInterface $request) : void
Parameters
- $request : ServerRequestInterface
createUri()
protected
createUri([array<string|int, mixed> $parameters = [] ]) : string
Parameters
- $parameters : array<string|int, mixed> = []
Return values
stringgetBackendFavicon()
Retrieves configured favicon for backend with fallback.
protected
getBackendFavicon(ExtensionConfiguration $extensionConfiguration, ServerRequestInterface $request) : string
Parameters
- $extensionConfiguration : ExtensionConfiguration
- $request : ServerRequestInterface
Return values
stringgetBackendUser()
protected
getBackendUser() : BackendUserAuthentication
Return values
BackendUserAuthenticationgetBodyTagAttributes()
protected
getBodyTagAttributes() : array<string, string>
Return values
array<string, string> —Array of body-tag attributes
getBodyTagParameters()
protected
getBodyTagParameters() : string
Return values
stringgetBParamDataAttributes()
Splits parts of $this->bparams and returns needed data attributes for the Javascript
protected
getBParamDataAttributes() : array<string, string>
Return values
array<string, string> —Data attributes for Javascript
getLanguageService()
protected
getLanguageService() : LanguageService
Return values
LanguageServicegetNormalizedParams()
protected
getNormalizedParams(ServerRequestInterface $request) : NormalizedParams
Parameters
- $request : ServerRequestInterface
Return values
NormalizedParamsgetRequest()
protected
getRequest() : ServerRequestInterface
Return values
ServerRequestInterfacegetUriForFileName()
Returns the uri of a relative reference, resolves the "EXT:" prefix (way of referring to files inside extensions) and checks that the file is inside the project root of the TYPO3 installation
protected
getUriForFileName(ServerRequestInterface $request, string $filename) : string
Parameters
- $request : ServerRequestInterface
- $filename : string
-
The input filename/filepath to evaluate
Return values
string —Returns the filename of $filename if valid, otherwise blank string.
getViewModeButton()
protected
getViewModeButton() : ButtonInterface
Return values
ButtonInterfaceinitialize()
Loads additional JavaScript
protected
initialize(ServerRequestInterface $request) : void
Parameters
- $request : ServerRequestInterface
initSelectedFolder()
protected
initSelectedFolder() : void
initVariables()
protected
initVariables(ServerRequestInterface $request) : void
Parameters
- $request : ServerRequestInterface
loadStylesheets()
Load all registered stylesheets from $GLOBALS['TYPO3_CONF_VARS']['BE']['stylesheets']
protected
loadStylesheets(PageRenderer $pageRenderer) : void
Parameters
- $pageRenderer : PageRenderer
setUpBasicPageRendererForBackend()
Sets mandatory parameters for the PageRenderer.
protected
setUpBasicPageRendererForBackend(PageRenderer $pageRenderer, ExtensionConfiguration $extensionConfiguration, ServerRequestInterface $request, LanguageService $languageService) : void
Parameters
- $pageRenderer : PageRenderer
- $extensionConfiguration : ExtensionConfiguration
- $request : ServerRequestInterface
- $languageService : LanguageService