smtech / grading-analytics
跟踪并呈现Canvas中教师行为丰富的反馈(类似于学生课程分析数据)
Requires
- battis/data-utilities: ^0.1
- battis/simplecache: ^1.0
- myclabs/php-enum: ^1.0
- npm-asset/chart.js: ~2.2
- pear/log: ~1.12
- smtech/stmarks-reflexive-canvas-lti: ^0.2
This package is auto-updated.
Last update: 2023-05-25 12:43:18 UTC
README
生成有关教师评分实践的某些报告。要开始自动化数据收集,请运行一次private/data-collection.sh脚本。它将收集第一轮数据,然后创建cronab作业,以便每晚午夜重复此过程。
收集的信息描述可在网上获取。
安装
要求
- Apache 2
- MySQL 5.5或更高版本
- PHP 5.6或更高版本
- Composer
步骤
这通常遵循标准的PHP应用程序安装模式,并增加了一些额外的兴奋元素。
- 将存储库克隆到您的Web根目录。
cd path/to/web/root
git clone https://github.com/smtech/grading-analytics.git
- 运行设置脚本(这将安装依赖项,设置文件权限,安排Cron作业等。--它在做的时候会告诉你它在做什么,并且它将定期要求sudo密码)。
cd grading-analytics
./setup
-
编辑新创建的
config.xml
文件,包括应用程序的凭据(用于数据存储的MySQL登录凭证以及用于与Canvas API通信的凭据--开发密钥和密钥或API访问URL和令牌)。 -
将浏览器指向安装以完成应用程序设置(这将读取配置文件,设置数据库表等)。
https://server.com/path/to/grading-analytics
如果您以后需要重新运行安装过程,请将浏览器指向
https://server.com/path/to/grading-analytics?action=install
安装过程的最终结果是带您进入LTI消费者管理页面,在那里您需要创建新的消费者密钥和密钥。
-
在Canvas中安装API。它应该安装在其包含所有将被监控的课程子帐户中,例如,我们将它安装到包含我们所有系级子帐户的Academics子帐户中。使用Canvas的“通过URL”选项粘贴来自消费者管理页面的消费者密钥,共享密钥和配置URL。
-
访问LTI的帐户导航位置以完成安装(这将通过LTI身份验证捕获根帐户的帐户ID,这允许数据收集脚本知道要监控哪个帐户)。
从v1.x升级到v2.0
从1.x分支切换到2.0的原因主要围绕底层LTI身份验证结构的变化。这要求现有用户重新运行上述应用程序安装过程(步骤1-4),然后还重新在Canvas中安装LTI(步骤5-6)。
底层数据在1.x和2.0分支之间是保留不变的。然而,LTI结构的变化也在MySQL数据库中创建了一个tool_metadata
表,它取代了app_metadata
表,可以被删除。
在course_statistics
表中,我选择运行一个快速脚本来更新所有的analytics_page
字段,以便指向新的LTI安装,但这并不是必需的,因为一旦收集到新数据,那些旧链接就不再可见了。