README

用于同步Toggl与Redmine的PHP命令行工具。

时间条目同步

目前仅提供time-entry-sync。

• 从Toggl到Redmine的单向同步
• Toggl标签名称与Redmine的映射
• 同步状态在Toggl中标记为标签#synched

安装

使用composer进行安装简单。安装composer后，您可以选择全局安装或在项目中安装。

全局

在全局安装中，toggl2redmine将作为一个命令行工具可用。

• 运行composer global require derhasi/toggl2redmine进行全局安装。
• 将export PATH=~/.composer/vendor/bin:$PATH添加到您的.bashrc或.profile

安装后，您应该能够在任何地方运行toggl2redmine time-entry-sync ...。

本地

您可以在任何启用composer的项目中运行composer require derhasi/toggl2redmine以将此项目作为依赖项添加。

使用方法

您可以通过添加选项、使用配置文件或同时使用它们来运行全局或本地命令。命令行参数或选项将始终覆盖来自toggl2redmine.yml的设置。

全局：toggl2redmine.php time-entry-sync ...

本地：./toggl2redmine time-entry-sync ...

命令行参数和选项

Usage:
 time-entry-sync [--workspace="..."] [--fromDate="..."] [--toDate="..."] [--defaultActivity="..."] redmineURL redmineAPIKey tooglAPIKey

Arguments:
 redmineURL            Provide the URL for the redmine installation
 redmineAPIKey         The APIKey for accessing the redmine API
 tooglAPIKey           API Key for accessing toggl API

Options:
 --workspace           Workspace ID to get time entries from
 --fromDate            From Date to get Time Entries from (default: "-1 day")
 --toDate              To Date to get Time Entries from (default: "now")
 --defaultActivity     Name of the default redmine activity to use for empty time entry tags (default: "")

配置

您可以在当前工作目录中放置一个toggl2redmine.yml作为本地默认设置。对于全局默认设置，您可以在~/.toggl2redmine/toggl2redmine.yml中放置它。注意：本地和全局默认设置将不会合并。如果存在，本地默认值始终优先于全局默认值。

您可以在default.toggl2redmine.yml找到toggl2redmine.yml的模板。确保将其重命名为toggl2redmine.yml！

例如，要将默认配置模板添加到全局文件夹，您只需输入

mkdir ~/.toggl2redmine
curl https://raw.githubusercontent.com/derhasi/toggl2redmine/master/default.toggl2redmine.yml > ~/.toggl2redmine/toggl2redmine.yml