Download the PHP package cpsit/typo3-personio-jobs without Composer
On this page you can find all versions of the php package cpsit/typo3-personio-jobs. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cpsit/typo3-personio-jobs
More information about cpsit/typo3-personio-jobs
Files in cpsit/typo3-personio-jobs
Package typo3-personio-jobs
Short Description TYPO3 CMS Extension to integrate jobs from Personio Recruiting API
License GPL-2.0-or-later
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package typo3-personio-jobs
An extension for TYPO3 CMS that integrates jobs from Personio Recruiting API into TYPO3. It provides a console command to import jobs into modern-typed value objects. In addition, plugins for list and detail views are provided with preconfigured support for Bootstrap v5 components.
🚀 Features
- Console command to import jobs from Personio Recruiting API
- Usage of modern-typed value objects during the import process
- Plugins for list and detail view
- Optional support for JSON Schema on job detail pages using EXT:schema
- Compatible with TYPO3 11.5 LTS, 12.4 LTS and 13.0
🔥 Installation
Composer
💡 If you want to use the JSON schema feature, you must
additionally require the schema extension:
TER
Alternatively, you can download the extension via the TYPO3 extension repository (TER).
First-step configuration
Once installed, make sure to include the TypoScript setup at
EXT:personio_jobs/Configuration/TypoScript in your root template.
⚡ Usage
Plugins
The extension provides two plugins:
| Icon | Description |
|---|---|
| Personio: Job list Lists all imported jobs as unordered list. Each list item shows the job title, office and schedule and links to the job's detail view. |
|
| Personio: Job detail Shows a single job, including several job properties and all imported job descriptions. In addition, it renders a button to apply for the job. |
Command-line usage
personio-jobs:import
The following command parameters are available:
| Command parameter | Description | Required | Default |
|---|---|---|---|
storage-pid |
Storage pid of imported jobs | ✅ | – |
-f, --force |
Enforce re-import of unchanged jobs | – | no |
--no-delete |
Do not delete orphaned jobs | – | no |
--no-update |
Do not update imported jobs that have been changed | – | no |
--dry-run |
Do not perform database operations, only display changes | – | no |
💡 Increase verbosity with --verbose or -v to show all changes,
even unchanged jobs that were skipped.
Code usage
The Personio job import process can also be triggered directly within PHP. For this, two services exist:
PersonioApiServiceprovides the main functionality to fetch jobs from Personio API and return them as hydratedJobmodels. Note that these jobs are not yet persisted. Instead, they only represent the current Personio job feed as strong-typed value objects.PersonioImportServiceprovides additional functionality to actually persist imported jobs. Under the hood, the previously mentionedPersonioApiServiceis called to fetch jobs, followed by their actual persistence. For the import process, a set of import settings is available:int $storagePid: Page ID where to persist new or updated jobs.bool $updateExistingJobs = true: Define whether to update jobs that were already imported, but have changed in the meantime.bool $deleteOrphans = true: Define whether to delete jobs that are no longer available on Personio.bool $forceImport = false: Select whether existing, unchanged jobs should be re-imported.bool $dryRun = false: Do not perform any persistence operations, just fetch and validate jobs.
Fetch jobs from Personio API
Import jobs from Personio API
JSON schema
In combination with EXT:schema, a JSON schema for a single job is included
on job detail pages. It is rendered as type JobPosting and includes some
generic job properties.
⚠️ The schema extension must be installed to use this feature. Read more in
the installation section above.
📂 Configuration
TypoScript
The following TypoScript constants are available:
| TypoScript constant | Description | Required | Default |
|---|---|---|---|
plugin.tx_personiojobs.view.templateRootPath |
Path to template root | – | – |
plugin.tx_personiojobs.view.partialRootPath |
Path to template partials | – | – |
plugin.tx_personiojobs.view.layoutRootPath |
Path to template layouts | – | – |
Extension configuration
The following extension configuration options are available:
| Configuration key | Description | Required | Default |
|---|---|---|---|
apiUrl |
URL to Personio job page, e.g. https://my-company.jobs.personio.de |
✅ | – |
Routing configuration
On each import, a slug is generated. The slug can be used for an advanced routing configuration of job detail pages.
Example:
⏰ Events
PSR-14 events can be used to modify jobs and job schemas. The following events are available:
AfterJobsImportedEventAfterJobsMappedEventEnrichJobPostingSchemaEvent
🚧 Migration
0.4.x → 0.5.x
Decouple import process
Import process is moved to a separate service class.
- All import operations are now performed by the new
PersonioImportServiceclass. PersonioServicewas renamed toPersonioApiService. Replace all usages of this class by the new class name.- Import results are now properly displayed by objects of the new
ImportResultclass. - Public methods in
AfterJobsImportedEventhave changed to match the newImportResultclass. Use the new public methodAfterJobsImportedEvent::getImportResult()instead of previously available methods.
0.3.x → 0.4.x
Finalize SchemaFactory
SchemaFactory is now final and cannot
be extended anymore.
- Remove classes extending from
SchemaFactory. - Replace customizations of the
SchemaFactoryby an event listener for theEnrichJobPostingSchemaEventPSR-14 event.
🧑💻 Contributing
Please have a look at CONTRIBUTING.md.
💎 Credits
The Personio logo as part of all distributed icons is a trademark of Personio SE & Co. KG.
⭐ License
This project is licensed under GNU General Public License 2.0 (or later).
All versions of typo3-personio-jobs with dependencies
ext-json Version *
ext-mbstring Version *
cuyz/valinor Version ^1.3
eliashaeussler/valinor-xml Version ^1.0
psr/event-dispatcher Version ^1.0
psr/http-message Version ^1.0 || ^2.0
symfony/console Version ^5.4 || ^6.0 || ^7.0
typo3/cms-core Version ^11.5 || ^12.4 || ~13.0.0
typo3/cms-extbase Version ^11.5 || ^12.4 || ~13.0.0
typo3/cms-frontend Version ^11.5 || ^12.4 || ~13.0.0