README

简介

in2studyfinder 是一个免费且通用的 TYPO3 扩展，它允许以结构化的方式添加、维护和显示不同可筛选视图的学业课程。本扩展是基本版本，可以通过各种字段、功能和接口进行扩展，并且已被不同大学广泛使用。

安装

使用 Composer 安装 in2studyfinder： composer require in2code/in2studyfinder 或从 [GitHub](https://github.com/in2code-de/in2studyfinder) 下载最新版本，或在 TER 或扩展管理器中安装 in2studyfinder。如果您想在前端使用最小样式（例如，如果您不想自己设置样式），请包括 in2studyfinder 的 TypoScript 模板 "Basic Template" 和 "CSS Template"。在您的页面树中创建一个存储文件夹，用于添加您的学业课程，并将 in2studyfinder 的所有 settingsPids 和 storagePids 设置为存储文件夹的 UID。

目标群体

从以下 TYPO3 网站开始

• 学院 + 高等学校
• 大学 + 大学

示例

屏幕截图

TH OWL 主页上的集成

TH OWL 中的列表视图

TH OWL 中的详细视图

TUM 中的列表视图

乌尔姆大学中的列表视图

链接

• 实时示例
  • 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/
• 查看完整描述（仅限德语）：[https://www.in2code.de/produkte/studiengangsfinder/](https://www.in2code.de/produkte/studiengangsfinder/)
• 对扩展或接口连接感兴趣？请联系我们：sandra.pohl@in2code.de

单个模块和功能

in2studyfinder 可以通过单个导入器（例如，从 SLCM、Hochschulkompass、HIS 等）进行扩展。还可以通过新字段或附加表扩展它，或添加新功能，如关键字筛选。请向 Sandra 求取有关附加模块或如果您需要专业服务的更多信息。

https://www.in2code.de/produkte/studiengangsfinder/

sandra.pohl@in2code.de

要求

版本 6.x

• TYPO3 8.7 或 9.5
• PHP 5.6

版本 7.x

• TYPO3 9.5 或 10.4
• PHP 7.2

版本 8.x - 10.x

• TYPO3 11.5
• PHP 7.4 - 8.0

版本 11.x 及以上

• TYPO3 12.4 及以上
• PHP 8.1 及以上

事件

ManipulateCsvPropertyBeforeExport：此事件允许在导出到 CSV 之前修改值

贡献

欢迎所有贡献。

为了简化贡献，我们提供了一个 ddev 设置。

1. 安装 ddev
2. 分支并克隆项目
3. cd my/project
4. ddev start
5. ddev initialize
6. 打开 [https://studyfinder.ddev.site/typo3/](https://studyfinder.ddev.site/typo3/)
7. 使用 admin 和 password 进行后端登录

快乐编码

构建 CSS 和 JavaScript

需求：node.js、npm、nvm

cd Resources/Private && nvm use
npm install

后端

npm run build:backend

前端

npm run build:frontend

JavaScript 事件

您可以在特定事件上执行自己的JavaScript代码。

示例

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

extend.js

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

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

API

Studyfinder

实例

暂无。

筛选

暂无。

快速搜索

暂无。

分页

代码质量工具

我们使用phpmd和phpcs进行代码质量检查。质量检查将在提交前通过预提交钩子自动执行。

一些违规可以通过phpcs修复器（phpcbf）自动修复。要自动修复，请执行ddev ssh，然后./.build/bin/phpcbf

手动执行测试

PHPCS

ddev ssh
./.build/bin/phpcs

PHPMD

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

PHPCBF

ddev ssh
./.build/bin/phpcbf

迁移

从版本8到9的迁移 从版本9到10的迁移 从版本10到11的迁移

外部使用的库

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

常见问题解答

• Q1：我可以使用fe_users或tt_address来处理人员吗？
• A1：当然可以，您可以通过TypoScript将人员映射到任何现有表中。
• Q2：我需要从外部服务导入人员，但如何操作？
• A2：请向in2code咨询专业服务或定制导入器。

变更日志