Updating
If you update EXT:yellowpages2 to a newer version, please read this section carefully!
Upgrade to version 10.0.0
Companies are created and edited in the frontend with a form based on
EXT:form now, see Company form in the Management plugin. The Extbase form of the Management
plugin has been removed.
Requirements
- The system extension EXT:form (
typo3/cms-form
) is required.
The site set
jweiland/depends on the site setyellowpages2 typo3/now, which providesform plugin.in the frontend. If you include the TypoScript of yellowpages2 without the site set, include the TypoScript of EXT:form, too.tx_ form - EXT:maps2 12.3.0 or higher (
jweiland/maps2
) is required. It
was optional before. Its form element
Maps2Poirenders the map step of the company form. The site setPosition jweiland/depends on the site setyellowpages2 jweiland/now. Configure the map provider of EXT:maps2 as described in its documentation.maps2- default
Plugin configuration
- The
Managementplugin has the actionslist,My Companies perform,confirmandActivation activate. The actionsnew,create,editandupdateof theManagementand the completeController Map(actionsController new,create,editandupdate) have been removed. Links to them do not work anymore. -
Link to the action
performto create a company and to the actionperformwith the argumentcompanyto edit a company:<f:link.action action="perform" controller="Management" pluginName="Management" pageUid="{settings.pidOfManagementPage}" arguments="{company: company}"> Edit company </f:link.action>Copied! - Logged-in frontend users need to be member of the user group of
yellowpages2.to create companies. Before, everyone who could open the page could create a company.user Group
Activation of companies
The activation link of the moderation mail opens the new action
confirm, which shows a summary of the company and a button.
The button activates the company via POST. The action activate does not
activate the company via GET anymore, but redirects to the confirmation
page, so mail security scanners and link previews can not activate
companies. The result is shown as flash message of the Directory plugin.
If you have overridden Templates/, keep
<f: in it.
The Restrict has been removed. The actions
confirm and activate check the moderation on their
own and show an error message, if it is missing or invalid.
Two steps instead of a separate map step
The map step of the Map is the second page of the company form
now. The address is geocoded when the first page is submitted, the user can
correct the position on the second page. The company is stored only once,
after the second page was submitted:
- A new company is no longer stored before the map step. So no hidden company without confirmed position is left behind, if the user leaves the form on the map step.
- Each company created or edited in the frontend is hidden and the moderator gets a mail with links to edit and to activate it. Before, an edited company was only hidden and announced, if the map step was completed. Edits of moderators with the link of the mail are handled the same way, so the moderator activates the company afterwards.
- The mail of the moderator is rendered with the templates of the
EXT:form finisher
Email(see Moderation of companies of the company form) and contains a text part now.To Receiver - The POI collection of a new company is created with the corrected position. The POI collection of an edited company is updated, instead of creating a new one.
Frontend markup uses Bootstrap 5
The templates of yellowpages2 and the company form use the classes of
Bootstrap 5. On a page with Bootstrap 5 the output works without own CSS
or template overrides. The company form uses the template variant
version2 of EXT:form, see Markup of the company form.
The following classes have been replaced in the templates and partials of the plugins. Update your overrides and your CSS:
| Before | Now |
|---|---|
f3- of the pagination | nav with aria-, pagination, page- and
page- |
thumbnail grid_ of the logo | float-, the image gets
img- |
floatright of the map image | float- |
| images of the company without class | img- in an ul. |
| search form without classes | mb-, form-, form-, form- and
btn btn-. The select and the text field got labels. |
no | alert alert- |
| submit button of the activation without class | btn btn- |
The icon spans with the classes icon-, icon-,
icon-, icon- and icon- have been removed, as
Bootstrap 5 contains no icon font. Telephone and fax number are prefixed
with the labels Telephone and Fax instead of the icons. Add your own
icons in overrides of the templates, if needed. The new label page
is the aria- of the pagination.
The links to create a company and to list the own companies are rendered
above the search form instead of below the list, left aligned like the
edit link of a company. If you override
Templates/, move the partial
Company/ accordingly.
Removed templates
If you have overridden one of these templates or partials in your site
package, remove them. Adapt the form with a copy of
EXT: instead (see
Configuration of the company form).
Templates/,Management/ New. html Templates/Management/ Edit. html Templates/,Map/ New. html Templates/,Map/ Create. html Templates/,Map/ Edit. html Templates/(the moderation mail isMap/ Update. html Resources/andPrivate/ Form Framework/ Templates/ Finishers/ Email/ Company Moderation. html Companynow)Moderation. txt Partials/,Company/ Form Fields. html Partials/,Company/ Field. html Partials/,Company/ Fields/*. html Partials/Form Errors. html
If you have overridden Partials/ or
Partials/, change the action of the links
from edit and new to perform. The partial root path
EXT: has been removed from
plugin..
TypoScript and site settings
- New site settings
yellowpages2.,form. storage Pid yellowpages2.andform. rich Text. enable yellowpages2., see Site Set settings and Rich text editor in the frontend form.form. rich Text. elements - New TypoScript
plugin.to override values of the form definition, see Configuration of the company form.tx_ yellowpages2. settings. override Form plugin.is the folder of the upload elements of the form now. Its default value istx_ yellowpages2. settings. new. upload Folder 1:/.user_ upload/ tx_ yellowpages2/ plugin.has been removed. The form is rendered with the Bootstrap 5 template varianttx_ yellowpages2._ CSS_ DEFAULT_ STYLE version2of EXT:form.
Removed PHP code
Map,Controller Location,Service Apply,Upload Folder Event Listener CheckandFal Uploads Event Listener Removehave been removed.Empty Trades Modifier Posthas been removed.Process Controller Action Event:: get Map Controller () Pathhas been removed. UseSegment Helper:: update Path Segment For Company () Path.Segment Helper:: generate Path Segment () - The
#and[File Upload] #attributes of the[Validate] Companymodel have been removed. The values of the form are validated by the validators of the form definition. - The rights checkbox of EXT:checkfaluploads has to be added to a copy of the form definition, see Rights checkbox of EXT:checkfaluploads.
Labels
The labels create, update, company, company,
please, hint, error., error.,
error, error, email.,
email. and all csh* labels have been removed from
locallang.. The labels of the form are part of
locallang_.
Upgrade to version 9.0.1
Since version 9.0.0 the frontend functionality is split into three plugins: Directory
(Company: list, show), Management (Management and Map:
create, edit and moderate companies) and Search (Search). Links between these
plugins need the target plugin and page. Configure the new site settings
yellowpages2. and yellowpages2. (see
Site Set settings) to the pages where the Management and Search plugins are inserted.
If you have overridden one of the following templates in your own site package, add plugin
and page to the links and forms targeting another plugin:
Partials/,Company/ Insert Edit Links. html Partials/:Company/ Properties. html pluginName="Management" page Uid=" {settings. pid Of Management Page}" Partials/:Company/ Search. html pluginName="Search" page Uid=" {settings. pid Of Search Results}" Partials/,Company/ List. html Templates/,Company/ Show. html Templates/:Management/ List My Companies. html pluginName="Directory" Templates/,Map/ Create. html Templates/(moderation mail): changeMap/ Update. html controller="Company"tocontroller="Management"and addpluginName="Management" page Uid=" {settings. pid Of Management Page}"
<f:link.action action="edit"
controller="Management"
pluginName="Management"
pageUid="{settings.pidOfManagementPage}"
absolute="1"
arguments="{company: company, moderationToken: moderationToken}">
Edit record
</f:link.action>
Upgrade to version 9.0.0
This version closes a security issue and changes how company logo and image uploads are handled.
The activate action, used by the link in the administrator notification email to publish a
company record straight away, previously had no authorization check at all. Anyone who knew or
guessed a company's UID could activate it. activate, edit, and update now require a signed
moderation request argument in addition to (or, for activate, instead of) the existing
frontend user check. If you have overridden Templates/ or
Templates/ in your own site package, add moderation to the arguments of
both f: calls, otherwise the links in the email no longer work:
<f:link.action action="edit" controller="Management" absolute="1"
arguments="{company: company, moderationToken: moderationToken}">
Edit record
</f:link.action>
Company logo and image uploads have been migrated to Extbase's native # API
(TYPO3 >= 13.3), replacing the extension's own Upload property mapper and
Assign, both of which have been removed. If you have overridden
Partials/ or Images., replace the old per-index upload fields
(logo., images. through images.) with the native multi-file pattern:
<f:form.upload property="logo" multiple="1"/>
<f:form.upload property="images" multiple="1"/>
Domain, get, get, and
get have been removed. Their former callers should use get,
get, get, and get instead, which now return the underlying
Object directly rather than a plain array. Code iterating these values in Fluid keeps
working unchanged; PHP code expecting a plain array must call ->to itself.
The classic static template registration under Configuration/ has been removed in
favor of the jweiland/ Site Set. If your site still relies on the classic "Include
static (from extensions)" template mechanism instead of Site Sets, add the
jweiland/ Site Set to your site's dependencies in config., see
Site Set settings.
Upgrade to version 7.0.0
This version is focused on upgrading the compatibility version to TYPO3 version 12 LTS. We moved some extension functionalities from PSR-14 Event Listeners to Middlewares as the request setArgument not possible anymore with TYPO3 version 12.
Upgrade to version 6.1.0
If you make use of the Modify or
Modify event:
We have changed the strict type of TYPO3 QueryBuilder to Extbase
QueryResult. Yes, this is a breaking change, but it seems that no one
makes use of it. Please adapt your code to use QueryResult. You can retrieve
the Extbase query with method get.
Upgrade to version 6.0.0
As TYPO3 has deprecated the ObjectManager, we have changed many properties in our
scheduler task Update yellowpages. Please remove that scheduler task completely
and create a new one of type Inform users to update their company record.
We have changed a lot of classes. Please click the Flush Cache button in the Install Tool
to rebuild the Dependency Injection cache.
If you have maps2 version 9 installed you have to override or change following
part in Properties. from:
<f:link.action title="Map detail"
action="show"
controller="PoiCollection"
extensionName="maps2"
pluginName="maps2"
pageUid="{settings.pidOfMaps2Plugin}"
arguments="{poiCollectionUid: company.txMaps2Uid}">
to:
<f:link.action title="Map detail"
action="show"
controller="PoiCollection"
extensionName="maps2"
pluginName="maps2"
pageUid="{settings.pidOfMaps2Plugin}"
arguments="{poiCollection: company.txMaps2Uid}">
Upgrade to version 5.0.0
We have moved a lot of code of yellowpages2 controllers to EventListeners. Please flush the cache in the maintenance module.
As a developer, you should check whether you have overwritten some methods of MapController or CompanyController and adapt them to the new structure.
Upgrade to version 4.0.0
We have removed column wsp_member as this column was specific to one of our customers. If you have used it, you have to add it back with the help of EXT:extender.
We have removed column icon from table sys_category. This also removed fallbackIconPath. If you have used it, you have to add it back with the help of EXT:extender.
We are using the API of glossary2 now. Please check whether your own queries are still working.