itmedia2
jweiland/itmedia2
main
en
Stefan Froemken
This document is published under the Creative Commons BY 4.0 license.
Wed, 07 Jan 2026 18:04:23 +0000
With this extension you can build your own industry directory
Table of Contents:
With itmedia2 you can build your own little industry directory for your
TYPO3 website. It comes with a list and a configurable detail view. Above the
list view we implemented an A-Z navigation to jump directly to industry
directory entries which will start with clicked starting letter.
This extension is a lightweight version of yellowpages2 without a frontend
form, without mailing, without scheduler task.
Target group: Editors
General PluginPlugin select IT & Media from selectbox.District
Reduce industry directory records on website to this district
CompanyIf your TYPO3 installation works in composer mode, please execute following command:
composer req jweiland/itmedia2
vendor/bin/typo3 extension:setup --extension=itmedia2If you work with DDEV please execute this command:
ddev composer req jweiland/itmedia2
ddev exec vendor/bin/typo3 extension:setup --extension=itmedia2On non composer based TYPO3 installations you can install itmedia2 still
over the ExtensionManager:
Login
Login to backend of your TYPO3 installation as an administrator or system maintainer.
Open ExtensionManager
Click on Extensions from the left menu to open the ExtensionManager.
Update Extensions
Choose Get Extensions from the upper selectbox and click on
the Update now button at the upper right.
Install itmedia2
Use the search field to find itmedia2. Choose the itmedia2 line
from the search result and click on the cloud icon to install itmedia2.
This chapter describes the various configuration settings of itmedia2.
Some general settings for itmedia2 can be configured in Admin Tools -> Settings.
int
Only valid, if you have installed EXT:maps2, too.
While creating location records we catch the address and automatically create a maps2 record for you. Define a storage PID where we should store these records.
itmedia2 needs some basic TypoScript configuration. To do so you have
to add an +ext template to either the root page of your website or to a
specific page which contains the itmedia2 plugin.
Locate page
You have to decide where you want to insert the TypoScript template. Either
root page or page with itmedia2 plugin is OK.
Create TypoScript template
Switch to template module and choose the specific page from above in the
pagetree. Choose Click here to create an extension template from the
right frame. In the TYPO3 community it is also known as "+ext template".
Add static template
Choose Info/ from the upper selectbox and then click
on Edit the whole template record button below the little table. On
tab Includes locate the section Include static . Use
the search above Available items to search for itmedia2. Hopefully
just one record is visible below. Choose it, to move that record to
the left.
Save
If you want you can give that template a name on tab "General", save and close it.
Constants Editor
Choose Constant Editor from the upper selectbox.
itmedia2 constants
Choose PLUGIN. from the category selectbox to show
just itmedia2 related constants
Configure constants
Adapt the constants to your needs. We prefer to set all
these pid and pid constants. That prevents you
from setting all these PIDs in each plugin individual.
Configure TypoScript
As constants will only allow modifying a fixed selection of TypoScript
you also switch to Info/ again and click on Setup. Here you have
the possibility to configure all itmedia2 related configuration.
array
EXT:itmedia2/Resources/Private/Templates/
plugin.tx_itmedia2.view.*
You can override our Templates with your own SitePackage extension. We prefer to change this value in TS Constants.
array
EXT:itmedia2/Resources/Private/Partials/
plugin.tx_itmedia2.view.*
You can override our Partials with your own SitePackage extension. We prefer to change this value in TS Constants.
array
EXT:itmedia2/Resources/Layouts/Templates/
plugin.tx_itmedia2.view.*
You can override our Layouts with your own SitePackage extension. We prefer to change this value in TS Constants.
int
plugin.tx_itmedia2.persistence
Set this value to a Storage Folder (PID) where you have stored the records.
int
plugin.tx_itmedia2.settings
Define the page UID where the EXT:maps2 plugin is located to show an address on a map.
int
plugin.tx_itmedia2.settings
If you have inserted the Industry Directory plugin for detail view onto another page, you can set its PID to this property here.
int
1
plugin.tx_itmedia2.settings
Merge record titles starting with numbers to 0- in glossary.
int
1
plugin.tx_itmedia2.settings
Prepend an additional button in front of the glossary to show all records again.
int
15
plugin.tx_itmedia2.settings
Reduce result of records to this value for a page
This chapter describes how to manage the extension from a superuser point of view.
With TYPO3 9 you have the possibility to configure RouteEnhancers
routeEnhancers:
Itmedia2Plugin:
type: Extbase
extension: Itmedia2
plugin: Directory
routes:
-
routePath: '/first-company-page'
_controller: 'Company::list'
-
routePath: '/company-page-{page}'
_controller: 'Company::list'
_arguments:
page: '@widget_0/currentPage'
-
routePath: '/company-by-letter/{letter}'
_controller: 'Company::list'
-
routePath: '/show/{company_title}'
_controller: 'Company::show'
_arguments:
company_title: company
requirements:
letter: '^(0-9|[a-z])$'
company_title: '^[a-zA-Z0-9]+$'
defaultController: 'Company::list'
aspects:
company_title:
type: PersistedAliasMapper
tableName: tx_itmedia2_domain_model_company
routeFieldName: path_segmentIf you update itmedia2 to a newer version, please read this
section carefully!
We have changed some method arguments, please flush cache in InstallTool
We have removed column wsp_member as this column was a specific column for one of our customers. If you have used it you have to add it back with help of EXT:extender.
We have removed column icon from table sys_category. That way we also have removed fallbackIconPath, too. If you have used it you have to add it back with help of EXT:extender.
We are using the API of glossary2 now. Please check, if your own queries are still working.