Add personio sync plugin to store/marketplace

_data/developer.yml

@@ -175,3 +175,13 @@ lnngyn:
     description: Software developer and Totoro lover
     image: https://avatars.githubusercontent.com/u/112909403?v=4
     github: https://github.com/lnNgyn1
+
+unicorn-development:
+    name: Unicorn Development AG
+    description: IDM, Customer portal and data integration experts
+    intro: Unicorn Development AG is a German company specialized in software developments for their customers and cheering Kimai users. Based in Möhnesee, the company operates in Digital Integration, Data Transmission and integrations for for the swift transfer and updating of documents and data.
+    image: /images/layout/avatar/unicorn-development.webp
+    homepage: https://www.unicorn-development.de
+    github: https://github.com/unicorn-development
+    linkedin: https://www.linkedin.com/company/unicorn-development-ag/
+    email: [email protected]

_data/en/store.yml

@@ -134,6 +134,9 @@ items:
     owlysk-codetimer-mobile:
         title: CodeTimer Mobile
         intro: Android client for Kimai (free and open-source)
+    unicorn-development-personio:
+        title: Personio Sync
+        intro: If you use Personio for your time accounting, push recorded Kimai timesheets as a worktime summary to Personio time accounting
 screenshots:
     cloudrizon-kimai-mobile-app-android0:
         description: Start screen of the app
@@ -277,3 +280,11 @@ screenshots:
         description: Timesheet listing of your recent records
     owlysk-codetimer-mobile-screen2:
         description: Configure your Kimai connection settings
+    unicorn-development-personiosync-user:
+        description: Personio user time accounting overview
+    unicorn-development-personiosync-admin:
+        description: Personio admin time accounting overview
+    unicorn-development-personiosync-user-detail:
+        description: Personio user time accounting detail view
+    unicorn-development-personiosync-admin-detail:
+        description: Personio admin time accounting detail view

_data/screenshots.yml

@@ -169,4 +169,12 @@ lnngyn-period-insert-bundle0:
 owlysk-codetimer-mobile-screen1:
     src: "/images/marketplace/owlysk-codetimer-mobile-screen1.webp"
 owlysk-codetimer-mobile-screen2:
-    src: "/images/marketplace/owlysk-codetimer-mobile-screen2.webp"
+    src: "/images/marketplace/owlysk-codetimer-mobile-screen2.webp"
+unicorn-development-personiosync-user:
+    src: "/images/marketplace/unicorn-development-personiosync-user.webp"
+unicorn-development-personiosync-admin:
+    src: "/images/marketplace/unicorn-development-personiosync-admin.webp"
+unicorn-development-personiosync-user-detail:
+    src: "/images/marketplace/unicorn-development-personiosync-user-detail.webp"
+unicorn-development-personiosync-admin-detail:
+    src: "/images/marketplace/unicorn-development-personiosync-admin-detail.webp"

_data/store/releases/PersonioSyncBundle.yaml

@@ -0,0 +1,2 @@
+versions:
+    - [ "1.0", "2.0" ]

_data/store/unicorn-development-personio.yml

@@ -0,0 +1,15 @@
+developer: unicorn-development
+icon: fas fa-person-circle-check
+demo: false
+subscription: 199 €
+shop: "https://store.unicorn-development.de/buy/bd31e00b-f6a7-467c-a45a-2951a0c25103"
+tags: [ plugin, sync ]
+changelog: true
+bundle:
+    name: "PersonioSyncBundle"
+    purchase: true
+screenshots:
+    - unicorn-development-personiosync-user
+    - unicorn-development-personiosync-admin
+    - unicorn-development-personiosync-user-detail
+    - unicorn-development-personiosync-admin-detail

_includes/store/changelog/PersonioSyncBundle.md

@@ -0,0 +1,5 @@
+**Version 1.0**
+
+Compatibility: requires minimum Kimai 2.0.0
+
+Initial published version.

_includes/store/unicorn-development-personio.md

@@ -0,0 +1,55 @@
+## Description
+
+This plugin integrates a Kimai installation into [Personio](https://worksimple.personio.de/) a SaaS HR/HCM and process automation solution. Personio offers the ability to account employee working hours. This functionality is partly overlaping with Kimai functionality. Use of this plugin avoids the neccassity that users have to enter data twice (Kimai and Personio) to account for working hours.
+
+Timesheets are consolidated against overlappings and then transferred to Personio. Information about the linked Personio time accounting is stored. This way a differential sync is possible after the initial sync to speedup the sync process. Each time a timesheet within Kimai is changed the according Personio time accounting entries are updated during the sync job run.
+
+The project entity within Personio is not used, synced or linked to the transferred entries.
+
+## Installation
+
+After installation (see Installation), open 'PersonioSyncBundle\Resources\config\services.yaml' and enter your personio client id and client secret.
+
+To communicate with Lexoffice however, you need to install GuzzleHttp:
+(run this command on /var/www/kimai, NOT /var/www/kimai/var/plugins)
+```bash
+composer require guzzlehttp/guzzle
+```
+
+We are currently working on removing GuzzleHttp as a dependency.
+
+Keep in mindo to rebuild the cache:
+```bash
+bin/console kimai:reload -n
+```
+
+{% include snippets/composer-update-warning.md %}
+
+## Usage
+
+Navigate to kimai:
+```bash
+cd /var/www/kimai
+```
+
+Execute the plugin command to execute the sync or plan it as a cronjob:
+```bash
+bin/console kimai:bundle:personio-sync:sync-attendances
+```
+
+To remove all links to Personio in Kimai, the following command can be used:
+```bash
+bin/console kimai:bundle:personio-sync:reset-sync-state
+```
+
+## Recommendations
+
+While using the Kimai sync of time accounting entries into Personio it is recommended to remove the rights for all users to modify their time accounting entries. This can be done by modifing the default employee role within Personio.
+
+## Support
+
+If you need help setting this plugin up or have any feature requests our commercial support is available at [[email protected]](mailto:[email protected])
+
+## Legal notice
+
+All product names, trademarks and registered trademarks (e.g. Personio) are property of their respective owners. All company, product and service names used in this website are for identification purposes only. Use of these names,trademarks and brands does not imply endorsement.

collections/_store/unicorn-development-personio.md

@@ -0,0 +1,7 @@
+---
+title: Personio Sync
+type: plugin
+lang: en
+---
+
+{% include store/unicorn-development-personio.md %}