PHPackages                             hauerheinrich/hh-simple-job-posts - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. hauerheinrich/hh-simple-job-posts

ActiveTypo3-cms-extension[Admin Panels](/categories/admin)

hauerheinrich/hh-simple-job-posts
=================================

Adds plugins for list / show job postings with meta-data and schema.org stuff. Uses tt\_address for job-contacts and job-location.

5.0.0(1y ago)1961GPL-2.0-or-laterPHP

Since Jan 11Pushed 7mo ago2 watchersCompare

[ Source](https://github.com/Hauer-Heinrich/hh_simple_job_posts)[ Packagist](https://packagist.org/packages/hauerheinrich/hh-simple-job-posts)[ Fund](https://www.paypal.com/paypalme/hauerheinrich)[ RSS](/packages/hauerheinrich-hh-simple-job-posts/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (7)Versions (30)Used By (0)

hh\_simple\_job\_posts
======================

[](#hh_simple_job_posts)

hh\_simple\_job\_posts is a TYPO3 extension. Lists and shows job posts / job offers incl. schema.org stuff (e. g. for google jobs) and if you have EXT:hh\_seo loaded meta-tags. Uses EXT:hh\_tt\_address\_places.

### optional

[](#optional)

- \[hh\_seo\] - works well with: [https://github.com/Hauer-Heinrich/hh\_seo](https://github.com/Hauer-Heinrich/hh_seo) - required if you want use Partial/MetaTags.html

### Installation

[](#installation)

... like any other TYPO3 extension

- create a folder at the TYPO3 backend tree in which addresses of hiring-organisations are stored.
    Then set the UID of this folder at the TYPO3 constants editor (\[plugin.tx\_hhsimplejobposts.persistence.storagePidOrganizations\])
    Optional: add PageTs from EXT:"hh\_tt\_address\_places - Allow only Places".

    ##### ATTENTION:

    [](#attention)

    - Make sure that the field "company" is not disabled!
    - It is required that the field 'tx\_extbase\_type' is set to 'place'! This is done automatically if you have added the PageTs to this folder: "hh\_tt\_address\_places - Allow only Places".
- create a folder at the TYPO3 backend tree in which addresses of contact-point-addresses are stored.
    Then set the UID of this folder at the TYPO3 constants editor (\[plugin.tx\_hhsimplejobposts.persistence.storagePidContactPointAddresses\])
    Optional: add PageTs from EXT:"hh\_tt\_address\_places - Allow only people".
- create a folder at the TYPO3 backend tree in which jobs are stored.
    Optional: add PageTs from EXT:hh\_simple\_job\_posts "Additional / extra config for: jobposts". Optional: e. g. if you want see your jobs at Google-Jobs then you must meet the requirements of Google\\

    - Sets requierd fields for Google add PageTs from EXT:hh\_dimple\_job\_posts "Additional / extra config for: jobposts google jobs"
- Optional: for nice URLs you can use the example at EXT:hh\_simple\_job\_posts/sites/config.yaml

### Job-list and Job-detail on the same page

[](#job-list-and-job-detail-on-the-same-page)

### Disable all other content on this site/page if detail view of job-posts is given

[](#disable-all-other-content-on-this-sitepage-if-detail-view-of-job-posts-is-given)

In this Example you should replace "MainContent" with your own one! TypoScript example ([https://github.com/Hauer-Heinrich/hh\_simple\_job\_posts/blob/master/Configuration/TypoScript/example.typoscript](https://github.com/Hauer-Heinrich/hh_simple_job_posts/blob/master/Configuration/TypoScript/example.typoscript)):

```
[request && (traverse(request.getQueryParams(), 'tx_hhsimplejobposts_jobslist/jobpost') > 0 || traverse(request.getQueryParams(), 'tx_hhsimplejobposts_jobsdetail/jobpost') > 0)]

    ### In our current opinion better solution:
    ### Create a new colPos for your TYPO3 backendlayout
    ### and show this colpos only if the detail view of job-posts is given
    ### Example if you have in your main typoscript theme config something like the following 2 lines

    ### page.10.variables.MainContent =< styles.content.get
    ### page.10.variables.MainContent.select.where = colPos = 1

    ### then add this "[traverse ...] from above with this next 3 lines in it
    # page.10.variables.MainContent >
    # page.10.variables.MainContent =< styles.content.get
    # page.10.variables.MainContent.select.where = colPos = 100

    ### alternative: most used way like for EXT:news
    # lib.leftcontent = USER
    # lib.leftcontent {
    #     userFunc = TYPO3\CMS\Extbase\Core\Bootstrap->run
    #     pluginName = Jobslist
    #     extensionName = HhSimpleJobPosts
    #     vendorName = HauerHeinrich
    #     controller = Jobpost
    #     action = show

    #     view < plugin.tx_hhsimplejobposts.view
    #     persistence < plugin.tx_hhsimplejobposts.persistence
    #     settings < plugin.tx_hhsimplejobposts.settings
    # }
    # page.10.variables.MainContent =< lib.leftcontent
[global]

```

### Translations via TypoScript

[](#translations-via-typoscript)

```
### Example:
plugin.tx_hhsimplejobposts {
    _LOCAL_LANG {
        de {
            detail.maintasks = Deine Aufgaben
            detail.profile = Dein Profil
            detail.skills = Deine Skills
            detail.weprovide = Das erwartet dich bei uns
            detail.hiringOrganization = Oder per Post an:
            detail.phone.before = Tel.:
            detail.contact_point_email.before = Ihre Anfrage/Bewerbung senden Sie bitte an:
            detail.contact_point_telephone.before = Tel.:
            detail.contact_point_telephone.after =
        }
    }
}

```

### Features

[](#features)

- automatically generates config for sitemap (EXT:seo)
- compatible with EXT:hh\_seo
- shippes default config for nice-urls see example: Configuration/Typo3/sites/config.yaml
- provides psr-14 events

#### prepare fields for json e. g. json-ld / schema.org

[](#prepare-fields-for-json-e-g-json-ld--schemaorg)

RTE fields are available in the Fluid template as “jobpost.escapedRteFields” for example “{jobpost.escapedRteFields.description}”.

### Available events

[](#available-events)

When register to an event you can always access the class where the event is fired. For additional items see column "Access to" in the table below.

Event classFired in classAccess toJobpostsListEventJobpostControllergetAssignedValues(), getSettings()#### Event description

[](#event-description)

- JobpostsListEvent: You can set your own Jobposts, for example from external API Example Usage see extension [https://github.com/Hauer-Heinrich/hh\_talentstorm\_job\_posts](https://github.com/Hauer-Heinrich/hh_talentstorm_job_posts)Add your own "useExternalApi" setting, see: Configuration\\TsConfig\\Page\\TCEFORM.typoscript

#### Connect to event

[](#connect-to-event)

To connect to an event, you need to register an event listener in your custom extension. All what it needs is an entry in your Configuration/Services.yaml file:

```
services:
  Vendor\Extension\EventListener\YourListener:
    tags:
      - name: event.listener
        identifier: 'your-self-choosen-identifier'
        method: 'yourMethodToConnectToEvent'
        event: HauerHeinrich\HhSimpleJobPosts\Event\JobpostsListEvent
```

#### Write your EventListener

[](#write-your-eventlistener)

An example event listener can look like this:

```