in2code/in2studyfinder

TYPO3 extension in2studyfinder

Introduction

in2studyfinder is a free and generic TYPO3 extension, which makes it possible to add, maintain and display courses of studies in a structured way with different filterable views. This extension is the basic version, which can be extended by various fields, functions and interfaces and is already widely used by different universities., _(*1)

Installation

Require in2studyfinder via copmoser: composer require in2code/in2studyfinder or download a current version from [https://github.com/in2code-de/in2studyfinder](in2studyfinder on github) or install in2studyfinder from TER or in the Extension Manager. Include in2studyfinder's TypoScript Template "Basic Template" and "CSS Template" if you want to have a minimum of styles in the frontend (e.g. if you don't want to style it yourself). Create a storage folder in your page tree where you will add your study courses and set all settingsPids and storagePids of in2studyfinder to the storage folder's UID., _(*2)

Target group

TYPO3 Websites from, _(*3)

• Colleges + Hochschulen
• Universities + Universitäten

Examples

Screenshots

Integration at the home page of TH OWL:, _(*4)

, _(*5)

Listview at TH OWL:, _(*6)

, _(*7)

Detailview at TH OWL:, _(*8)

, _(*9)

Listview at TUM:, _(*10)

, _(*11)

Listview at Uni Ulm:, _(*12)

, _(*13)

Links

• Live examples:
  • https://www.tum.de/studium/studienangebot/
  • https://www.uni-ulm.de/studium/studieren-an-der-uni-ulm/studiengaenge/
  • https://www.th-owl.de/studium/angebote/studiengaenge/
• See full description (german only) under: https://www.in2code.de/produkte/studiengangsfinder/
• Interest in an extension or interface connection? Contact us: sandra.pohl@in2code.de

Individual modules and functions

in2studyfinder can be extended by individual importers (e.g. from SLCM, Hochschulkompass, HIS, etc.). It's also possible to extend it with new fields or additional tables or add new functions like a keyword filter. Please ask Sandra for more information about additional modules or if you need professional services:, _(*14)

https://www.in2code.de/produkte/studiengangsfinder/, _(*15)

sandra.pohl@in2code.de, _(*16)

Requirements

Version 6.x:, _(*17)

• TYPO3 8.7 or 9.5
• PHP 5.6

Version 7.x, _(*18)

• TYPO3 9.5 or 10.4
• PHP 7.2

Version 8.x - 10.x, _(*19)

• TYPO3 11.5
• PHP 7.4 - 8.0

Version 11.x and above, _(*20)

• TYPO3 12.4 and above
• PHP 8.1 and above

Events

ManipulateCsvPropertyBeforeExport: this event allows the manipulation of values before they are exported to the CSV, _(*21)

Contribution

Contributions are always welcome., _(*22)

In order to ease the contributions, we provide a ddev setup., _(*23)

1) install ddev 2) fork and clone project 3) cd my/project 4) ddev start 5) ddev initialize 6) open https://studyfinder.ddev.site/typo3/ 7) use admin and password for backend login, _(*24)

Happy coding, _(*25)

Build Css and JavaScript

Requirements: node.js, npm, nvm, _(*26)

cd Resources/Private && nvm use
npm install

Backend

npm run build:backend, _(*27)

Frontend

npm run build:frontend, _(*28)

Javascript Events

it is possible to execute your own javascript code on specific events., _(*29)

Example:, _(*30)

page.includeJSFooter.studyfinderExtenal = EXT:YOUREXTENSION/Resources/Public/JavaScript/extend.js

extend.js:, _(*31)

if (window.in2studyfinder !== null) {
    let in2studyfinder = window.in2studyfinder;
    let instance = in2studyfinder.getInstance(0);

    instance.pagination.afterLoad = function() {
        console.log('after Load');
    };
}

API:

Studyfinder:, _(*32)

Instance:, _(*33)

nothing yet., _(*34)

Filter:, _(*35)

nothing yet., _(*36)

Quicksearch:, _(*37)

nothing yet., _(*38)

Pagination:, _(*39)

Code quality tools

we use phpmd and phpcs for code quality checks. The quality checks will be executed automatic before a commit with a pre-commit hook., _(*40)

Some violations can be fixed automatic with the phpcs fixer (phpcbf). For automatic fixes execute ddev ssh and then ./.build/bin/phpcbf, _(*41)

Execute Tests manually:

PHPCS:, _(*42)

ddev ssh
./.build/bin/phpcs

PHPMD:, _(*43)

ddev ssh
./.build/bin/phpmd Classes/ ansi .phpmd.xml

PHPCBF:, _(*44)

ddev ssh
./.build/bin/phpcbf

Migration

Migrations from version 8 to 9 Migrations from version 9 to 10 Migrations from version 10 to 11, _(*45)

External used libraries

* https://tom-select.js.org/

FAQ

• Q1: Can I use fe_users or tt_address for the persons?
• A1: Of course, you can map persons to any existing table via TypoScript
• Q2: I need to import persons from an external service, but how?
• A2: Please ask in2code for professional service or individual importers

Changelog