teufels / tt3-career-importer
There is no license information available for the latest version (dev-main) of this package.
Importer for [teufels] Career
Package info
bitbucket.org/teufels/tt3-career-importer/
Type:typo3-cms-extension
pkg:composer/teufels/tt3-career-importer
dev-main
2026-11-18 18:47 UTC
Requires
- cobweb/external_import: dev-develop
- cobweb/svconnector_csv: ^6.0
- cobweb/svconnector_feed: ^6.0
- cobweb/svconnector_json: ^6.0
- teufels/tt3-career: ^3.3 || dev-release/TYPO3v14
- typo3/cms-core: ^13.4 || ^14.3
- typo3/cms-reactions: ^13.4 || ^14.3
- typo3/cms-scheduler: ^13.4 || ^14.3
Requires (Dev)
None
Suggests
- league/commonmark: ^2.0 (required for TextTransformation::markdownToHtml, e.g. LogaHR)
- teufels/svconnector_cornerstone: dev-release/TYPO3v14
- teufels/svconnector_successfactors: dev-release/TYPO3v14
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-18 18:49:05 UTC
README
[ ṯeufels ] Career Importer
Importer for [ ṯeufels ] Career
- import job offers from external sources with the external_import Extension
This version supports TYPO3
Composer support
composer req teufels/tt3-career-importer
Requirements
"typo3/cms-core": "^13.4 || ^14.3""typo3/cms-scheduler": "^13.4 || ^14.3""typo3/cms-reactions": "^13.4 || ^14.3""teufels/tt3-career": "dev-release/TYPO3v14"(will be^4.0with the release of tt3-career 4.0.0)"cobweb/external_import": "dev-develop"(9.x, as long as there is no official release with TYPO3 v14 support)"cobweb/svconnector_csv": "^6.0""cobweb/svconnector_feed": "^6.0""cobweb/svconnector_json": "^6.0"
Suggestion
"league/commonmark": "^2.0"(required forTextTransformation::markdownToHtml, e.g. LogaHR)"teufels/svconnector_cornerstone": "^6.0""teufels/svconnector_successfactors": "^6.0"
** for other types require the corresponding connector: https://docs.typo3.org/p/cobweb/external_import/main/en-us/User/General/Index.html
Supported Import sources
- Persis (XML)
- Personio (XML)
- Odoo (JSON)
- Cornerstone (API/JSON)
- require teufels/svconnector_cornerstone
- SAP SuccessFactors (API/JSON)
- require teufels/svconnector_successfactors
- Mingle.ro (JSON)
- LogaHR (XML)
Notice
- PHP 8.5 compatible, TYPO3 Extension Scanner (v14.3) reports no findings
- the custom
OffsetPaginatorrequirescobweb/svconnector_json ^6.0 - column option
excludedOperationswas removed in external_import 3.0, usedisabledOperations SuccessfactorsTransformation::parseDate: optionfunction => strftimewas removed,formatis always adate()format
LogaHR (loga_xml)
- only the fixed base fields are mapped by default:
id,title,url,location,country(raw),mandantDescription,referenceNumber(=>reference_number, requiresteufels/tt3-career>= 3.3.0) - the free configurable slots (
selection1-7,text10-12,longtext1-6) differ per customer => map them in the sitepackage longtext*contain Markdown (CommonMark:### Headline ###,__bold__,* list), not HTML => convert withTextTransformation::markdownToHtml(see below)contentis the application form text, not the job description => not imported- the XML contains no language information: one import per language (uri parameter
lang: D/E), setsys_language_uidper import in the sitepackage - the ids differ between the languages => records are imported as independent records (
l10n_parent= 0), not as translations - set
whereClause(sys_language_uid) per language import, otherwise the imports delete each other's records - query parameters (individually in sitepackage) via
parameters.requestOptions.query:jobPortal,lang,companyEid(*= all),tenant(empty = default)svconnector_feedhas noqueryParameters(onlysvconnector_jsonhas),requestOptionsrequiressvconnector_feed ^6.0queryreplaces a query string given inuri
Markdown to HTML (TextTransformation::markdownToHtml)
- source independent: usable for every import source that delivers Markdown (not Loga specific)
- requires the optional package
league/commonmark(composer require league/commonmark:^2.0), without it the import stops with an exception - safe by default: raw HTML in the source is stripped, unsafe links (
javascript:etc.) are removed - parameters (all optional):
normalizeHeadings(defaulttrue): repairs headlines which are no valid CommonMark, e.g.### Title###or##Title ##removeFirstHeading(defaultfalse): removes a headline at the very beginning (e.g. if it only repeats the field label)headingOffset(default0): shifts the heading levels (###= h3), limited to h1-h6softBreakAsBr(defaultfalse): renders single line breaks inside a paragraph as<br />
- example (sitepackage, e.g. for the field
task):$GLOBALS['TCA'][$model]['columns']['task']['external']['loga_xml_de'] = [ 'field' => 'longtext4', 'transformations' => [ 10 => [ 'userFunction' => [ 'class' => \Teufels\Tt3CareerImporter\Transformation\TextTransformation::class, 'method' => 'markdownToHtml', 'parameters' => [ 'removeFirstHeading' => true, 'softBreakAsBr' => true, ], ], ], ], ];
Convert lists (TextTransformation::convertList)
- source independent: converts a separated list into another separator, e.g.
München:Köln:Berlin=>Berlin, Köln, München - tt3_career expects comma separated values (e.g.
location,additional_locations) to build the filter options and to filter - parameters (all optional):
separator(default:): separator of the source valueglue(default,): separator of the resultunique(defaulttrue): removes duplicatessort(defaultfalse): sorts alphabetically (umlaut aware with ext-intl)
- example (sitepackage, LogaHR
selection7"Stadt"):$GLOBALS['TCA'][$model]['columns']['location']['external']['loga_xml_de'] = [ 'field' => 'selection7Translation', 'transformations' => [ 10 => [ 'userFunction' => [ 'class' => \Teufels\Tt3CareerImporter\Transformation\TextTransformation::class, 'method' => 'convertList', 'parameters' => [ 'separator' => ':', 'sort' => true, ], ], ], ], ];
Quick Guide
- copy the appropriate general connector configuration part from the TCA Override of this extension into the sitepackage and adapt it to your needs
Documentation
Changelog
- see CHANGELOG.md