README

1. Features

easy integration
decide to hide/display fluidtemplate in frontend
render structured data to your job posting
more features coming soon

2. Usage

1) Installation

Installation using Composer

The recommended way to install the extension is by using Composer. In your Composer based TYPO3 project root, just do composer require pegasus/google-for-jobs.

Installation as extension from TYPO3 Extension Repository (TER)

Download and install the extension with the extension manager module.

2) Setup

Include the static TypoScript of the extension.
Create some location and job records on a sysfolder.
Create a plugin on a page and select at least the sysfolder as startingpoint.

3) Sitemap

Add the following code to your setup.typoscript

plugin.tx_seo.config {
  xmlSitemap {
    sitemaps {
      jobs {
        provider = TYPO3\CMS\Seo\XmlSitemap\RecordsXmlSitemapDataProvider
        config {
          table = tx_googleforjobs_domain_model_job
          sortField = uid
          lastModifiedField = tstamp
          pid = <page id containing job records>
          url {
            pageId = <your detail page id>
            fieldToParameterMap {
              uid = tx_googleforjobs_job[job]
            }
            additionalGetParameters {
              tx_googleforjobs_job.controller = Job
              tx_googleforjobs_job.action = show
            }
            useCacheHash = 1
          }
        }
      }
    }
  }
}

4) Routing Enhancer

Add the following code to your config.yaml

routeEnhancers:
  JobsPlugin:
    type: Extbase
    extension: GoogleForJobs
    plugin: Job
    routes:
      -
        routePath: '/{job_title}'
        _controller: 'Job::show'
        _arguments:
          job_title: job
    defaultController: 'Job::show'
    aspects:
      job_title:
        type: PersistedAliasMapper
        tableName: tx_googleforjobs_domain_model_job
        routeFieldName: path_segment

3. Administration

3.1. Versions and support

Update from 1.3 to higher Versions

Install Update via composer or from TYPO3 TER
Run the Upgrade Wizard from Admin Tools > Upgrade > Upgrade Wizard. You will be promted to create missing tables and fields, please do so
Next, execute the "Google For Jobs: migrate locations into seperate table" wizard. This will migrate your existing job locations into a seperate table
Modify your fluid templates accordingly

3.2. Contribution

Pull requests are welcome in general! Nevertheless please don't forget to add an issue and connect it to your pull requests. This is very helpful to understand what kind of issue the PR is going to solve.

Bugfixes: Please describe what kind of bug your fix solve and give us feedback how to reproduce the issue. We're going to accept only bugfixes if I can reproduce the issue.
Features: Feel free to contact us if u have some cool ideas or wishes.

3.3. Changelog

Read the full Changelog here.

pegasus / google-for-jobs

Maintainers

Details