=== Personio Integration Light ===
Contributors: laolaweb, threadi
Tags: personio, jobs, recruitment, employee
Requires at least: 5.9
Tested up to: 7.1
Requires PHP: 8.2
Requires CP:  2.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Stable tag: 5.6.1

Import and display your positions from [Personio](https://www.personio.com) directly on your website. Get full control over how they are displayed.

== Description ==

Import and display your positions from [Personio](https://www.personio.com) directly on your website. Get full control over how they are displayed.

Show application forms on your positions and transfer applications from your website to Personio with [Personio Integration Pro](https://laolaweb.com/plugins/personio-wordpress-plugin/).

[youtube https://www.youtube.com/watch?v=0qjFEbKFq3w]

#### Features

✅ manual or automatic import of open positions in German and English (other languages only in [Personio Integration Pro](https://laolaweb.com/plugins/personio-wordpress-plugin/))
✅ positions are indexable by search engines (SEO)
✅ each open position (incl. job description) under its own URL on your website
✅ data protection-friendly, as no applicant data is collected and stored
✅ multiple Blocks for Block Editor, 2 classic widgets and [shortcodes](https://github.com/threadi/wp-personio-integration-light/blob/master/doc/shortcodes.md)
✅ support for classic as well as block themes
✅ optionally group the lists by categories, departments, offices etc.
✅ some [WP CLI commands](https://github.com/threadi/wp-personio-integration-light/blob/master/doc/cli.md) for simplified handling of data
✅ compatible with WCAG
✅ compatible with Content Security Policy settings

#### Requirements

🔌 Personio account with enabled XML interface
🔌 PHP module SimpleXML

#### Hint ####

The output of the positions as a list is limited to a maximum of 10. Only in [Personio Integration Pro](https://laolaweb.com/plugins/personio-wordpress-plugin/) there is no limitation.

#### the Pro license includes:

➕ Native support for following PageBuilders: Avada, Beaver Builder, Bricks, Brizy, Divi 4 & 5, Elementor, Elements in GeneratePress Premium, SiteOrigin (SiteOrigin Widgets Bundle necessary), WPBakery
➕ Also compatible with Avia (from Enfold) and Kubio AI
➕ Multiple and customizable application forms incl. export of them via Personio API
➕ Support for multiple form handler like Avada Forms, Contact Form 7, Elementor Forms, Everest Forms, Fluent Forms, Forminator, Ninja Forms and WPForms
➕ Customization of slugs (URLs) for list and detailed views of positions
➕ Supports all languages Personio offers: German, English, French, Spanish, Dutch, Italian, Portuguese, Swedish, Finnish, Polish, Czech
➕ Support for multilingual plugins Bogo, Polylang, WPML, Weglot and TranslatePress
➕ Support for legal entities and other workplaces on positions
➕ Support for salaries for open positions
➕ Use GoogleMaps or OpenStreetMap for show you locations with open positions
➕ Use custom feature image on each position
➕ Assign unlimited custom files for download or videos on each single position
➕ Support for tracking of events with Matomo and Google Analytics 4
➕ Support for Open Graph (Facebook, LinkedIn, WhatsApp ...), Twitter Cards and Dublin Core (optionally configurable for all or single positions)
➕ Support full text search for positions in frontend
➕ Use multiple Personio-accounts in one website
➕ Additional import settings, e.g. intervals and partial import for very large lists of open positions and removing of inline styles from position descriptions
➕ RichSnippets for optimal findability via search engines like Google Jobs
➕ Support to embed positions from your website in other website via oEmbed (optionally configurable for all or single positions)
➕ Shortcode generator for individual views of lists and details
➕ Encrypt all sensitive data (e.g., applicant data and API credentials).
➕ ... and much more

🆙 [Get the Pro-Version](https://laolaweb.com/plugins/personio-wordpress-plugin/)

== ClassicPress ==

This plugin is compatible with [ClassicPress](https://www.classicpress.net/).

== Repository, documentation and reliability ==

The development repository is on [GitHub](https://github.com/threadi/wp-personio-integration-light).

We also provide several [hooks](https://github.com/threadi/wp-personio-integration-light/blob/master/doc/hooks.md) as help for developers.

The Personio logo as part of all distributed icons is a trademark of [Personio SE & Co. KG](https://www.personio.com).

Each release of this plugin will only be published if it fulfills the following conditions:

✅ Compliance with WordPress Coding Standards
✅ PHPStan check for possible bugs
✅ PHP Unit tests

---

== Installation ==

1. Upload "personio-integration-light" to the "/wp-content/plugins/" directory.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Enter your Personio URL in the settings.
4. Include one of the different output options for open positions in your company in your website.

== Frequently Asked Questions ==

= Can I use the plugin without a Personio account? =

The plugin can be installed even without a Personio account. However, it is unusable without Personio data.

= Does this plugin use iframes? =

No, no iframe of any kind is used to embed data.

= How can I use a form as an application form and submit the applications to Personio? =

This is supported by the Pro version of the plugin since version 2.0.0. You can find instructions on how to do this [here](https://github.com/threadi/wp-personio-integration-light/blob/master/doc/applications/quickstart.md).

= Does this plugin set any cookies or load data from external? =

No, this plugin does not set cookies, nor does it load data externally within the front end of the website. The exception is when images and videos are embedded in the job descriptions coming from Personio. In this case, please check to what extent this affects the privacy of your own website.

= Is this plugin GPRD-compatible? =

Yes, it is without any further settings.

== Screenshots ==

1. Setup leads you through the first import of your positions from Personio
2. The imported positions in WordPress
3. Main settings for the plugin
4. Your positions from Personio in the frontend of your website

== Upgrade Notice ==

= 5.0.0 =

Complete revision of the plugin. Please create a backup before installing version 5.0.0 or newer.

== Changelog ==

= 5.6.1 =
- Added Personio icon in the WordPress icon library (for WordPress >= 7.1)
- Added new logging events during plugin activation and deactivation
- Added more PHP Unit Tests running before each release
- Small updates for the API v2, but still not usable as Personio does not deliver most of the v1 data for positions
- Optimized cronjob handling, which now also supports automatic cron-healing if a server-side cronjob is used
- Changed the collapsible handling of settings in DataView
- Updated settings lib, now able to use all settings in DataView
- Changed the spelling of the subject for each email, which could send to the website-owner to be compatible with WordPress defaults
- Send test emails via AJAX to prevent site reload on the settings page
- Save the user-specific collapse state of sections in settings
- Updated settings lib to 3.3.1
- Fixed the statement to get our own Block templates from the database (thanks @philipp-marquardt)
- Fixed the removing of schedules with attributes during deactivation of the plugin
- Fixed a wrong default interval for the report by email
- Fixed the wrong selection of intervals for the report by email
- Fixed to prevent triggering the re-import hint on every settings save

[older changes](https://github.com/threadi/wp-personio-integration-light/blob/master/changelog.md)
