README

Contao recruitee Bundle

使用BROCKHAUS AG的Contao Recruitee Bundle，您可以通过Recruitee API创建新的应聘者。此外，还可以将Recruitee上发布的所有当前职位加载到您的网页上。

该组件是做什么用的？

Contao Recruitee Bundle允许您向Recruitee发送申请表单，并在您的网页上加载发布的当前职位。
您想知道如何操作吗？在"如何操作？"部分，我们已为您汇总了所有相关信息。

如何安装和配置该组件？

使用Contao Manager在您的Contao环境中或通过composer下载该组件。
在"contao/"下创建一个名为"settings"的文件夹。
在此文件夹中创建一个名为"brockhaus-ag"的文件夹。
然后，在"html/contao/brockhaus-ag"文件夹中创建一个名为"contao-recruitee-bundle"的文件夹。
在组件的"settings"文件夹中，您将找到一个"example"文件。重要：该文件必须以".json"结尾，而不是".jsonc"。
在"config.json"文件中，您需要指定您已在Recruitee中指定的位置。
1. 在"name"字段中，您输入您位置的名字。
2. 在"bearerToken"下，您输入Recruitee的Token，以便组件可以通过Recruitee API登录。
3. "companyIdentifier"点同样来自Recruitee。这个公司ID用于识别位置。
4. 在"category"下，您输入您的表单别名，以便组件可以识别表单。
5. 谷歌reCaptcha v3的配置（可选）
  1. 在"serverName"下，您输入请求中的服务器名
  2. 在"reCaptchaPrivateToken"下，设置由谷歌reCaptcha v3提供的私人Token
调整好文件后，您可以将它放置在"html/contao/settings/brockhaus-ag/contao-recruitee-bundle/"文件夹中。
完成所有步骤后，您可以继续下一步"我已完成，如何使用该组件？"。

我已完成，如何使用该组件？

该组件具有不同的功能

"/recruitee/reload-jobs"
1. 此功能用于重新加载通过Recruitee发布的所有职位。
2. 您可能已经考虑过，每次发布新职位时是否都需要更新职位。当然不是。请查看"如何自动更新我的职位？"部分。
"/recruitee/load-jobs"
1. 这是您的区域。我们开发了另一个页面，以便您可以格式化查看当前加载的职位。此外，还列出了日期和时间，以便您可以看到您的职位最后更新时间。
"/recruitee/load-json-jobs"
1. 与第2点不同，这是一个JSON格式的输出，用于在网页上显示您发布的职位。

如何自动更新我的职位？

您的职位可以通过在服务器提供商处设置Cron Job轻松更新。在Cron Job中调用URL "https://{ihre-url}.{tld}/recruitee/reload-jobs"。

~ 不久之后，您也将能够直接通过Contao后台创建Cron任务。

这是如何实现的呢？

现在只剩下一个问题：这是如何实现的？

创建新的应聘者

要创建一个新的应聘者，首先需要在您的网站上创建一个包含表单别名“bewerbung-”的表单。该表单必须包含“称呼”、“名”、“姓”、“电子邮件”和“消息”等表单字段。所有其他选项都是次要的。您可以在“后端API -> 发送应聘者”部分找到有关“表单”的更详细信息。
当通过您的表单发送申请时，Contao钩子会接收到申请。然后，这些申请数据将自动分割并转发到recruitee的API。

加载已发布的职位

如果您已经通过recruitee发布了职位，这些职位将通过API请求被加载。这些职位将被存储在一个包含最后更新时间戳的JSON文件中。例如，如果您现在调用“https://{ihre-url}.{tld}/recruitee/load-jobs”页面，将会加载JSON文件并在您的浏览器中输出职位。
有关如何在您的网站上显示职位或如何播放API的详细信息，请参阅“后端API -> 加载职位”部分。

后端API

发送应聘者

{
    // Formular Alias: bewerbung-experts
    "alias": "",
    // die Job Id, auf den sich der Bewerber bewirbt
    "jobID": "",
    // Anrede: Herr, Frau, Divers
    "bw_anrede": "",
    // Titel: Dr., Dipl., etc. 
    "bw_titel": "",
    // Vorname: Max
    "bw_vorname": "",
    // Nachname: Mustermann
    "bw_name": "",
    // E-Mail: max.mustermann@brockhaus-ag.de
    "bw_email": "",
    // 
    "profil_sonstiges": "",
    // https://github.com/BROCKHAUS-AG
    "github": "",
    // https://de.linkedin.com/company/brockhaus-ag
    "linkedin": "",
    // https://www.xing.com/pages/brockhausag
    "xing": "",
    //
    "bw_quelle": "",
   
   "bw_contact": "",
    // Bewerbungsanschreiben
    "anschreiben": [

    ],
    // Lebenslauf
    "lebenslauf": [

    ],
    // Zeugnisse
    "zeugnisse": [

    ],
    // Foto von Bewerber
    "foto": [

    ]
}

加载职位

[
   {
      // Stellenname des Jobs
      "stellenname": "",
      // Id aus recruitee
      "id": "",
      // Einsatzort (Stadt)
      "einsatzort": "",
      // Job Url zu recruitee
      "_url": "",
      // Kategorie (Alias für unterschiedliche Seiten)
      "kategorie": "",
      // Bild Alias
      "bildUrl": "",
      // Stellenbeschreibung mit HTML
      "stellenbeschreibung": "",
      "tags": [],
   },
   {
      "stellenname": "",
      "id": "",
      "einsatzort": "",
      "_url": "",
      "kategorie": "",
      "bildUrl": "",
      "stellenbeschreibung": "",
      "tags": [],
   }
]

brockhaus-ag / contao-recruitee-bundle

维护者

详情