https://github.com/xperseguers/staffdirectory

Directory of groups of persons and their department membership with RDFa support.
https://github.com/xperseguers/staffdirectory

Last synced: 1 day ago
JSON representation

Directory of groups of persons and their department membership with RDFa support.

• Host: GitHub
• URL: https://github.com/xperseguers/staffdirectory
• Owner: xperseguers
• License: gpl-3.0
• Created: 2024-01-25T09:35:35.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-07-12T07:45:38.000Z (3 months ago)
• Last Synced: 2024-09-14T07:41:07.605Z (19 days ago)
• Language: PHP
• Size: 541 KB
• Stars: 0
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Staffdirectory

## Suggested configuration

- Create a storage folder for your groups and persons

  - Edit its Page TSconfig to have:

     ```

     mod.web_list.allowedNewTables (

         fe_users,

         tx_staffdirectory_domain_model_organization

     )

     # This makes adding new fe_users much easier, adapt to your needs!

     TCAdefaults.fe_users {

         usergroup = 1

         username = nologin-

         password = __invalid__

         country = CH

         tx_extbase_type = tx_staffdirectory

     }

     ```

## Routing configuration

Nice URL can be configured by editing your site configuration (stored in

file `config/sites//config.yaml`):

```

routeEnhancers:

  Staffdirectory:

    type: Extbase

    limitToPages:

      - 

      - 

    extension: Staffdirectory

    plugin: Plugin

    routes:

      -

        routePath: '/p/{person-name}'

        _controller: 'Plugin::person'

        _arguments:

          person-name: person

      -

        routePath: '/o/{organization-name}'

        _controller: 'Plugin::organization'

        _arguments:

          organization-name: organization

    aspects:

      person-name:

        type: PersistedAliasMapper

        tableName: fe_users

        routeFieldName: path_segment

      organization-name:

        type: PersistedAliasMapper

        tableName: tx_staffdirectory_domain_model_organization

        routeFieldName: path_segment

```

Note: you may omit the `limitToPages` configuration but are advised to keep it.

## Sitemap configuration

You may generate a sitemap for your staff directory by adding the following

to your site's TypoScript (requires EXT:seo):

```

plugin.tx_seo.config.xmlSitemap.sitemaps {

    persons {

        provider = Causal\Staffdirectory\Seo\PersonsXmlSitemapDataProvider

        config {

            pid = PERSONS_STORAGE_UID

            recursive = 0

            url {

                pageId = SINGLE_PERSON_PAGE_UID

                fieldToParameterMap {

                    uid = tx_staffdirectory_plugin[person]

                }

                additionalGetParameters {

                    tx_staffdirectory_plugin.controller = Plugin

                    tx_staffdirectory_plugin.action = person

                }

                useCacheHash = 1

            }

        }

    }

}

```

You should naturally adapt `PERSONS_STORAGE_UID` and `SINGLE_PERSON_PAGE_UID`

to your actual page UIDs.

Further reading:

https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Seo/XmlSitemap.html