## 概要

Redmineのチケット管理に大いに役立てているタグプラグイン。ひっそりとサービス終了していたので、その後継に置き換えます。

## プラグイン名

- additonal_tags
- https://github.com/AlphaNodes/additional_tags
- インストール方法
- {{article(29)}} {{kb(29)}}

### 動作を確認した環境

Redmine 4.2

### 前提：

- 稼働要件にadditonalsプラグインが必要です。([インストール方法](https://atelier.reisalin.com/projects/zettel/knowledgebase/articles/29))
- additonalプラグインと同様に、2023年1月現在のバージョンはRedmine5.xから対応しているため、作業に少し手間が加わります。
- 既にredmine_tags (https://github.com/ixti/redmine_tags/) を導入している場合は、以下に示す手順によって設定済みのタグをインポートできます。

### 導入時

Gem追加：要
DBマイグレーション：要

## 手順

※**Redmine_Tagsを導入済みの場合は、バックアップを取り、失敗時に復旧できる準備をすることを強く推奨します。**

### さっくりとした手順

1. SSHログイン後、作業ディレクトリに移動
2. wgetでRedmine4.2に即したパッケージをダウンロード
3. パッケージの配置
4. **旧プラグインのディレクトリ削除**
5. 新規ジェムをインストール
6. DBマイグレーション
7. Webサービス再起動

#### Redmine4.2に即したバージョンをダウンロードして展開します。

```bash
wget https://github.com/AlphaNodes/additional_tags/archive/refs/tags/1.0.4.zip
# リリースノートで、Redmine 4.2に対応したバージョンがこれでした

unzip 1.0.4.zip

sudo chown -R www-data:www-data additional_tags-1.0.4/
# apache / nginxの実行ユーザに所有者を合わせます
```

#### Redmineディレクトリにプログラムを配置します。

```bash
sudo mv additional_tags-1.0.4 /home/www-data/redmine/plugins/additional_tags
# 自分の環境に合わせます。また、ディレクトリ名からバージョン名を外すのを忘れないようにしてください
```

#### インストール済みのRedmine_Tagsディレクトリを削除します。

※新規インストールの場合はこの作業は不要です

```bash
cd /home/www-data/redmine/plugins
# 自分の環境に合わせます。

ls -ld additional_tags redmine_tags
#2つのディレクトリがあることを確認します

sudo rm -rf redmine_tags

ls -ld additional_tags redmine_tags
#additonal_tagsのみがあることを確認します
```

#### Gemをインストールします

```bash
cd /home/www-data/redmine/
# 自分の環境に合わせます。

sudo -u www-data bundle install
```

#### DBのマイグレーションを行います

```bash
cd /home/www-data/redmine/
# 自分の環境に合わせます。

sudo -u www-data bundle exec rake redmine:plugins:migrate RAILS_ENV=production
```

#### Webサービスを再起動します。

```bash
sudo systemctl restart apache2
```

## インストール後の動作

1. Redmineに管理者アカウントでログインします。
2. 管理に移動すると、「Tags」メニューが追加されているのでクリックして移動します。
3. 以下の設定を行います。
- サイトバーにタグを：シンプルなクラウド
- タグに金額を表示(※Totalがこう和訳されています):チェック
- 課題タグを有効にする：チェック
4. Redmine_tagから移行している場合は、「タグの管理」タブで記載されたタグがあることを確認します。