Search by

teufels / tt3-career-importer

teufels

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/

Homepage

Type:typo3-cms-extension

pkg:composer/teufels/tt3-career-importer

Statistics

Installs: 22

Dependents: 0

Suggesters: 1

dev-main 2026-11-18 18:47 UTC

This package is auto-updated.

Last update: 2026-11-18 18:49:05 UTC


README

VENDOR PACKAGE KEY version

[ ṯeufels ] Career Importer

Importer for [ ṯeufels ] Career

  • import job offers from external sources with the external_import Extension

This version supports TYPO3

CUSTOMER CUSTOMER

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.0 with 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 for TextTransformation::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 OffsetPaginator requires cobweb/svconnector_json ^6.0
  • column option excludedOperations was removed in external_import 3.0, use disabledOperations
  • SuccessfactorsTransformation::parseDate: option function => strftime was removed, format is always a date() format

LogaHR (loga_xml)

  • only the fixed base fields are mapped by default: id, title, url, location, country (raw), mandantDescription, referenceNumber (=> reference_number, requires teufels/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 with TextTransformation::markdownToHtml (see below)
  • content is 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), set sys_language_uid per 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_feed has no queryParameters (only svconnector_json has), requestOptions requires svconnector_feed ^6.0
    • query replaces a query string given in uri

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 (default true): repairs headlines which are no valid CommonMark, e.g. ### Title### or ##Title ##
    • removeFirstHeading (default false): removes a headline at the very beginning (e.g. if it only repeats the field label)
    • headingOffset (default 0): shifts the heading levels (### = h3), limited to h1-h6
    • softBreakAsBr (default false): 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 value
    • glue (default , ): separator of the result
    • unique (default true): removes duplicates
    • sort (default false): 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