」と入力してください。 |
| https接続を強制する | チェックを入れます。 |
| 実行委員会の名称 | 学園祭実行委員会の名称を入力します。ここで入力された名前は、PortalDotsから送信されるメールの文面など、PortalDotsの画面上に表示されます。 |
| 実行委員会のメールアドレス | 学園祭参加企画からのお問い合わせを受け付けるメールアドレスを入力します。PortalDotsから送信された「お問い合わせ」はこのメールアドレスに届くほか、PortalDotsから送信されるメールの文面など、PortalDotsの画面上に表示されます。 |
| 学校発行メールアドレスのローカルパート種別 | 学校が学生に配布・発行しているメールアドレスについて、「@(アットマーク)」より前の文字列が下記のどちらに該当するかを選択してください。
- 学籍番号
- 学籍番号ではない文字列 (学籍番号に関係のない文字が1文字以上含まれている場合もこちらを選択)
|
| 学校発行メールアドレスのドメイン | 学校が学生に配布・発行しているメールアドレスの「@」より後の文字列を入力します。 |
上記以外の設定項目については、各学校・各学園祭の事情にあった情報を入力してください。
## 5.2.「MySQL データベース設定」
「MySQL データベース設定」では、「[2. データベースを作成する](/setup/install/coreserver/database)」でメモした情報を入力します。
| 設定項目 | 説明 |
| ----------- | --------------------- |
| データベースのホスト名 | メモした「Host」を入力します。 |
| ポート番号 | 半角数字で「3306」を入力します。 |
| データベース名 | メモした「Database」を入力します。 |
| ユーザー名 | メモした「Username」を入力します。 |
| パスワード | メモした「Password」を入力します。 |
## 5.3. 「メール配信設定」
「メール配信設定」では、「[3. メールアカウントを作成する](/setup/install/coreserver/email)」でメモした情報を入力します。入力後「保存して次へ」をクリックすると、「実行委員会のメールアドレス」に対してテストメールが送信されます。
| 設定項目 | 説明 |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| メールサーバー(SMTP)のホスト | メモした「SMTP Server」を入力します。 |
| メールサーバー(SMTP)のポート | メモした「port」(半角数字)を入力します。 |
| メールユーザー名 | メモした「Username」を入力します。 |
| メールパスワード | メモした「Password」を入力します。 |
| PortalDotsから配信されるメールの差出人メールアドレス | メモした「Username」を入力します。 |
| PortalDotsから配信されるメールの差出人の名前 | 任意の文字列を設定できます。ウェブシステムの名前や実行委員会の名前にするのがお勧めです。ここで設定した名前は、PortalDotsから送信されるメールをユーザーが確認する際、メールアプリの「差出人」欄に表示されます。 |
## 5.4. 「管理者ユーザーの設定」
1. 「管理者ユーザーの作成」では、あなた自身の情報を入力してください。
2. 「登録してインストール実行」をクリックすると、データベース上に PortalDots関連データの保存領域が作成され、管理者ユーザー情報がデータベース上に保存されます。
3. 「メール確認」ページが表示されます。「学校発行メールアドレス」と「連絡先メールアドレス」それぞれに1通ずつ確認メールが送信されます。それぞれのメールに記載されたURLにアクセスしてください。2通のURLにアクセスしたら、インストール完了です！
続いて、PortalDotsからメール配信を行うための設定を行います。
# ステップ7. メールの一斉配信機能のセットアップ(CRONの設定)
「お知らせ」をユーザー全員に一斉配信するためには、CRONの設定が必要です。
1. コアサーバーのコントロールパネルにログインします
2. 画面左のメニューから「ツール」をクリックします
3. 画面左側のメニューから「CRONジョブ」をクリックします
4. 「CRONジョブを作成」ボタンをクリックします
5. 「分」に「\*/10」と入力、「時間」「日」「月」「曜日」には「\*」と入力してください
6. 「コマンド」には `/usr/local/bin/php /home/〇〇/public_html/artisan schedule:run` と入力してください
* 〇〇の部分には、コアサーバーのコントロールパネルの画面右上に表示されている「アカウント」を入れてください。（以下の画像の〇〇の部分です）\
7. 「作成」ボタンをクリックします
8. 以上でCRON設定は完了です。「お知らせ」の一斉配信機能が利用可能になります。
以上でPortalDotsのインストールは完了です！お疲れ様でした！
# こんなときはどうする？
コアサーバー上でPortalDotsをセットアップしている間にトラブルが発生した場合、以下をご確認ください。
## インストール中にエラーが発生したとき
* **PHPバージョンが8.0以上かどうか確認してください。** PHPバージョンの変更方法は[コアサーバーのマニュアル](https://help.coreserver.jp/manual/v2/php-version/)を参照してください。
* 「MySQL データベース設定」や「メール配信設定」をしようとしてもエラーになる場合、入力したパスワードなどが間違っていないかご確認ください。
* 「データベースパスワード」と「メールパスワード」は、通常異なるパスワードです。「データベースパスワード」を入力するべきところ「メールパスワード」を入力してしまっているなど、パスワードの入力に誤りがないかご確認ください。
* 「ポータルの情報」設定で設定した「実行委員会のメールアドレス」によっては、「メール配信設定」時にエラーとなることがあります。その場合は、一度「ポータルの情報」設定に戻り、違う「実行委員会のメールアドレス」を設定してみてください。
## 「ポータルの情報」を設定後、PortalDots にアクセスできなくなったとき
SSL の設定をしていない状態で、「ポータルの情報」設定の「https 接続を強制する」にチェックを入れると、PortalDots にアクセスできなくなります。
* SSL の設定をしたにも関わらず PortalDots にアクセスできなくなった場合、サーバー側の SSL 設定の処理が完了していない可能性があります。しばらく待ってから再度 PortalDots にアクセスしてください。
* SSL の設定をしていない場合、「[4. 通信を暗号化するために SSL を設定する(無料)](/setup/install/coreserver/ssl)」に従って SSL の設定をした後、しばらく待ってから再度 PortalDots にアクセスしてください。
## それでも解決しないとき
[PortalDots の LINE 公式アカウント](https://lin.ee/aeee9s9)では、PortalDots のセットアップ方法や利用方法に関する質問を受け付けております(無料)。ぜひご活用ください。
{% hint style="warning" %}
PortalDots開発チームはボランティアによる活動です。LINEでのサポートは解決を保証するものではありません。予めご了承ください。
{% endhint %}
# PortalDotsのユーザー登録をしてもらう
PortalDotsの機能を最大限活用するには、学園祭参加企画の担当者と学園祭実行委員会のメンバー全員がPortalDotsにユーザー登録することが重要になってきます
## 概要
PortalDotsで構築したウェブシステム上で学園祭参加企画が参加登録を提出したり、実行委員がお知らせや申請フォームを作成したりするためには、PortalDotsで構築したウェブシステムに「**ユーザー登録**」する必要があります。
また、実行委員がPortalDotsの「スタッフモード」を利用するには、実行委員に「ユーザー登録」をしてもらった後、ウェブシステムの管理者が実行委員ユーザーを **「スタッフ」として登録する必要があります**。
本記事では、「ユーザー登録」をしてもらう必要がある方についてご説明します。また、「ユーザー登録」の方法についてご説明します。
## 「ユーザー登録」をする必要のある方
* **学園祭参加企画のメンバー**のうち、以下の方（PortalDots上で「企画参加登録」を提出するために「ユーザー登録」が必要）
* 参加企画の責任者
* 参加企画の副責任者（主に実行委員会とのコミュニケーションを担当される方。学園祭によっては「学園祭係」などと呼ばれることもあります）
* **学園祭実行委員会のメンバー**
* 全員が登録されることが望ましいですが、「お知らせ」や「配布資料」、「申請フォーム」の作成・管理される方だけが「ユーザー登録」を実施しても構いません
## 「ユーザー登録」の方法
1. PortalDotsで構築したウェブシステムにアクセスします。
2. ウェブシステムホーム画面にある「はじめての方は新規ユーザー登録」を選びます。
3. 学籍番号、名前、連絡先メールアドレス、連絡先電話番号、ウェブシステムにログインするためのパスワードを入力します。PortalDotsの設定によっては学校発行メールアドレスの入力が追加で必要な場合があります。
4. 学校発行メールアドレスと連絡先メールアドレスの両方に対して送信された確認メールを開き、メール文面内の URL にアクセスします。
5. `4.` で両方の URL にアクセスができ次第、「ユーザー登録」完了となります。
{% hint style="warning" %}
学園祭実行委員会のメンバーがPortalDotsの「スタッフモード」を利用できるようにするには、そのユーザーを「スタッフ」として登録する必要があります。詳細については『[実行委員ユーザーが「スタッフモード」にアクセスできるようにする](/setup/create-staff-user)』をご覧ください。
{% endhint %}
# 実行委員ユーザーが「スタッフモード」にアクセスできるようにする
実行委員がPortalDotsスタッフモードを利用できるようにする方法についてご説明します
## 概要
「ユーザー登録」のみを実施したユーザーは、PortalDots上では「一般ユーザー」として扱われます。PortalDotsの機能のうち、ユーザー情報や参加企画情報の閲覧・編集、「お知らせ」や「配布資料」、「申請フォーム」の作成・管理などの機能を利用したい場合、ユーザーを「スタッフ」として登録する必要があります。
{% hint style="info" %}
PortalDotsにユーザー登録する方法については「[PortalDotsのユーザー登録をしてもらう](/setup/user-registration)」をご覧ください。
{% endhint %}
## ユーザーを「スタッフ」として登録する
1. スタッフとしたいユーザーに、予め PortalDots にユーザー登録をしてもらいます。
2. 既にスタッフまたは管理者ユーザーとして登録しているアカウントで PortalDots にログインします。
3. 「スタッフモード」を開きます。
4. メニューから「ユーザー情報管理」を選びます。
5. スタッフとして追加したいユーザーを探し、当該ユーザーの(編集)ボタンを選びます。
6. 「ユーザー種別」を「スタッフ」に変更し、「保存」を選びます。
これで、当該ユーザーは「スタッフモード」にアクセスできるようになります。
{% hint style="info" %}
以上の手順とは別に、「スタッフ」ユーザーに対して「スタッフの権限設定」を実施しないと、そのユーザーはスタッフモードの機能を一切利用できません。
{% endhint %}
## 「スタッフの権限設定」で「スタッフ」ユーザーが「スタッフモード」内の機能を利用できるようにする
「ユーザー種別」が「スタッフ」のユーザーは、「管理者」ユーザーに「スタッフの権限設定」を行ってもらうまで、スタッフモードの各種機能は利用できません。管理者ユーザーは、以下に記載の方法で、スタッフユーザーが各種機能を利用できるように設定してください。
1. 既に管理者ユーザーとして登録しているアカウントで PortalDots にログインします。
2. 「スタッフモード」を開きます。
3. メニューから「スタッフの権限設定」を選びます。
4. 「スタッフモード」の機能を利用できるように設定したいユーザーを探し、当該ユーザーの✏️(編集)ボタンを選びます。
5. そのユーザーが利用できるようにする機能にチェックを入れ、「保存」を選びます。
{% hint style="warning" %}
セキュリティのため、各ユーザーが利用できる機能は最小限にしてください。例えば、企画情報の確認ができれば十分なユーザーには、企画の編集ができない「スタッフモード › 企画情報管理 › 閲覧」という権限を付与してください。
{% endhint %}
# 「一般モード」と「スタッフモード」
PortalDotsには「一般モード」と「スタッフモード」という2種類のモードがあります。「一般モード」は、学園祭の参加企画が利用するモードです。「スタッフモード」は、学園祭の実行委員(スタッフ)のみが利用できるモードです。
## それぞれのモードについて
PortalDotsには2種類のモードがあります。それぞれ利用可能なユーザーが異なります。
### 一般モード
学園祭の参加企画のメンバー(一般ユーザー)が利用するモードです。主に下記の機能が利用できます。
* 企画参加登録の提出
* お知らせ・配布資料の閲覧
* 申請フォームへの回答
* 学園祭実行委員会へのお問い合わせ、など
「一般モード」で利用できる機能の詳細については、「[PortalDotsでできること(一般モード)](/circles/list)」をご覧ください。
## スタッフモード
学園祭の実行委員(スタッフ)のみが利用できるモードです。主に下記の機能が利用できます。
* PortalDotsに登録されているユーザー情報の管理
* 企画・場所情報の管理
* 一般ユーザー向けに掲載するお知らせ・配布資料の作成、など
「スタッフモード」で利用できる機能については、「[PortalDotsでできること(スタッフモード)](/features/list)」をご覧ください。
# PortalDotsでできること(スタッフモード)
PortalDotsの基本機能をご紹介します。
PortalDotsには、学園祭実行委員会が学園祭を作り上げるために必要な機能が多数揃っています。ここでは、学園祭実行委員(スタッフ)が利用できるPortalDotsの基本機能の概要と使い方をご紹介します。
ここでご紹介している機能は一部です。今後も随時、機能紹介を追加していきます。
{% content-ref url="/pages/FMqa4dwgTCQEpxs3yTuf" %}
[PortalDotsを使って企画参加登録を受け付ける](/features/circle-registration)
{% endcontent-ref %}
{% content-ref url="/pages/93OSDODJ3oQ92ZFmUMpq" %}
[学園祭参加企画向けのお知らせを掲載・メール配信する](/features/pages)
{% endcontent-ref %}
{% content-ref url="/pages/pjbC3FcmCfmg8gPinNGH" %}
[学園祭参加企画にPDFなどのファイルを配布する](/features/documents)
{% endcontent-ref %}
{% content-ref url="/pages/bWIy1GOIyJmZ99urZaTG" %}
[学園祭当日に使用できる場所の一覧や各企画への場所の割り当てを管理する](/features/places)
{% endcontent-ref %}
{% content-ref url="/pages/8O1b0iT2m8fBqCSOTqYm" %}
[学園祭参加企画からの各種申請をオンラインで受け付ける](/features/forms)
{% endcontent-ref %}
{% content-ref url="/pages/CaTnwVfRPm1Jb7zuHEIw" %}
[学園祭参加企画からのお問い合わせを受け付ける](/features/contact-form)
{% endcontent-ref %}
{% hint style="info" %}
PortalDotsの機能のうち、学園祭の参加企画が利用可能な機能については「[PortalDotsでできること(一般モード)](/circles/list)」をご覧ください。
{% endhint %}
# PortalDotsを使って企画参加登録を受け付ける
PortalDotsを使えば、学園祭への企画参加登録をオンライン上で受け付けることができます。
## 概要
PortalDotsの「企画参加登録」機能を有効にすると、学園祭への企画参加登録をオンライン上で受け付けることができます。企画情報の入力から、責任者の登録、企画参加登録の提出までオンライン上で完結するため、企画参加登録を受け付ける手間が大幅に省けます。
受け付けた企画参加登録の一覧は、「スタッフモード」内の「企画情報管理」で確認でき、CSV形式で企画一覧をダウンロードすることもできます。「カスタムフォーム」機能を利用することで、企画参加登録フォームに独自の入力欄(設問)を追加することもできます。
また、企画参加登録フォームは複数作成できます。例えば、「模擬店」や「ステージ企画」の参加登録を別のフォームで受け付けられます。
## 「企画参加登録」機能の事前設定
### 「参加種別」を作成する
「企画参加登録」機能を利用するには、まず参加種別を作成する必要があります。
{% hint style="info" %}
**参加種別とは？** — 企画ごとに1つだけ設定できる参加形態です。例えば、「模擬店」という参加種別を作成しておき、模擬店として参加する企画の参加種別は「模擬店」に設定します。
{% endhint %}
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 「参加種別を作成」を選びます。
4. 「参加種別名」を入力し、「保存」を選びます。
{% hint style="warning" %}
「参加種別」を作成しただけでは、企画参加登録の受付は開始されません。企画参加登録の受付を開始するには、「参加登録フォームの設定」を行う必要があります。
{% endhint %}
### 「企画参加登録」の受付を開始する（参加登録フォームの設定）
「参加種別」を作成すると、「企画参加登録」機能の設定を変更することができるようになります。
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 参加登録フォームを作成したい参加種別を選びます。
4. 画面上部の「参加登録フォームの設定」タブを選びます。
5. 以下の表に記載されている設定項目を変更できる画面が表示されます。設定を確認・変更し、「保存」を選びます。
| 設定項目 | 説明 |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 企画参加登録のカスタムフォーム | 「企画参加登録」フォームでは、予め「企画名」と「団体名」の入力欄が表示されるようになっています。「カスタムフォーム」機能を使うことで、「企画名」と「団体名」以外の独自の入力欄(設問)を追加できます。
設問の追加・編集方法については、「フォームエディターで申請フォームを作成する」をご覧ください。
|
| 参加登録画面の公開設定 | 「企画参加登録」フォームを公開するには「公開する」にチェックを入れます。「公開する」にチェックが入っていても、受付開始日時以前や受付終了日時以降は公開されません。 |
| 受付開始日時 | 「企画参加登録」を受付開始する日時を入力します。この日時以前、企画参加登録画面はユーザーには非表示となります。 |
| 受付終了日時 | 「企画参加登録」を受付開始する日時を入力します。この日時以降、企画参加登録画面はユーザーには非表示となります。 |
| 企画参加登録を提出するために必要な企画担当者の人数 | 「企画参加登録」を提出する際に登録が必要な企画責任者と学園祭係(副責任者)の合計人数を設定できます。企画責任者に加え、学園祭係(副責任者)の登録を最低2人必要とする場合、3と入力してください。 |
| 参加登録前に表示する内容 | 「企画参加登録」フォームの冒頭に文章を表示することができます。「企画参加登録」にあたっての注意点や、企画参加規約などを表示する際にご活用ください。 |
| 参加登録の提出後に表示する内容 | 参加登録を完了した方に向けて表示するメッセージを設定できます。この内容は、参加登録の提出ユーザーに自動で送信されるメールにも表示されます。 |
## 「企画参加登録」を提出してもらった後は
参加企画側が「企画参加登録」を提出しただけでは**企画参加登録は完了しません**。スタッフ側で提出された「企画参加登録」を確認し、企画を「受理」することで「企画参加登録」が完了します。
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 参加種別を選びます。
4. 「登録受理状況」が「**確認中**」となっている企画の✏️(編集)ボタンを選びます。
5. 入力されている企画情報を確認し、「企画参加登録」を受理する場合は「参加登録の受理設定」にある「**受理**」にチェックを入れます。
6. 「保存」を選びます。
{% hint style="info" %}
「登録受理状況」を「受理」または「不受理」にチェックを入れると、その企画のメンバーに対し、企画が受理された(されなかった)旨が記載されたメールが送信されます。
{% endhint %}
{% hint style="info" %}
企画編集画面に表示されるその他の入力項目についての詳細は、「[学園祭参加企画を手動でPortalDotsに登録・編集する](/advanced/manual-circle-registration#no)」をご覧ください。
{% endhint %}
## 参加登録で作成された企画に自動でタグを付与する
PortalDotsでは企画を「タグ」で分類できます。例えば、模擬店の企画には「模擬店」というタグを設定しておくと便利です。また、企画のメンバーが[閲覧できるお知らせを制限](/features/pages#orasewonayznitsuite)したり、[回答可能な申請フォームを制限](/features/forms#fmuhenayznitsuite)したりする目的でもタグを利用できます。
しかし、参加登録を受け付けた後、一つ一つの企画についてタグを手動で設定していくのは面倒です。そこで「作成した企画に自動で追加するタグ」を設定しておくと便利です。
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 自動でタグを付与したい参加種別を選びます。
4. 画面上部の「参加種別を編集」タブを選びます。
5. 「作成した企画に自動で追加するタグ」を入力し、「保存」を選びます。
{% hint style="info" %}
これらのタグが自動的に追加されるのは、この設定を保存した後に作成される企画のみです。この設定を編集する前に作成された企画について遡って自動でタグを付与することはできません。
{% endhint %}
# 学園祭参加企画向けのお知らせを掲載・メール配信する
PortalDotsを使えば、学園祭に参加する企画向けのお知らせをオンライン上で掲載したり、メール配信したりすることができます。
## 概要
PortalDotsの「お知らせ」機能を利用することで、PortalDotsで構築した学園祭ウェブシステム上で「お知らせ」を掲載することができます。また、CRONが適切に設定されている場合、PortalDotsに登録されている全ユーザーに対して「お知らせ」をメール配信できます。
「企画情報管理」の「企画タグ」機能と併用することで、「お知らせ」を閲覧できるユーザーや、「お知らせ」のメール配信を受け取るユーザーを制限することもできます。
{% hint style="info" %}
CRONの設定方法はサーバーによって異なります。詳細は[セットアップ方法](/setup/install)をご覧ください。
{% endhint %}
## 「お知らせ」を作成する
1. 「スタッフモード」を開きます。
2. メニューから「お知らせ管理」を選びます。
3. 「新規お知らせ」を選びます。
4. 以下の表に記載されている入力欄が表示されます。入力欄に入力し終わったら「保存」を選びます。
| 入力項目 | 説明 |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| タイトル | 作成する「お知らせ」のタイトルを入力します。「お知らせ」をメール配信する場合は、このタイトルがメールの件名になります。 |
| 本文 | 作成する「お知らせ」の本文を入力します。 |
| 関連する配布資料 | 作成する「お知らせ」に添付したい配布資料を選択します。「配布資料」機能で予め作成した配布資料から選択できます。
PortalDotsの「配布資料」機能の詳細はこちらをご覧ください
|
| お知らせを閲覧可能なユーザー | （後述） |
| 公開設定 | 「公開」にチェックを入れるとお知らせが公開されます。「非公開」にチェックを入れるとお知らせは公開されません。 |
| お知らせを固定表示 | （後述） |
| 保存後にこのお知らせを「閲覧可能なユーザー」で指定したユーザー全員にメール配信 | 「お知らせ」を保存したタイミングで「お知らせ」のメール配信を行いたい場合、チェックを入れてください。 |
| スタッフ用メモ | 一般ユーザーには公開されないスタッフ用のメモを入力できます。 |
### 「お知らせを閲覧可能なユーザー」について
PortalDotsに登録されているユーザー全員に対して公開する必要がなく、一部のユーザーにだけ公開したい「お知らせ」がある場合、「お知らせを閲覧可能なユーザー」機能を使って「お知らせ」を閲覧できるユーザーを制限できます。
例えば、「講義棟教室の電源について」という「お知らせ」を、講義棟を利用する企画のメンバーに対してだけ公開したい場合、以下のように設定してください。
1. 予め「企画情報管理」で、講義棟を利用する企画の「企画タグ」入力欄に「**講義棟**」と入力しておく。
2. 「お知らせ」作成画面にある「お知らせを閲覧可能なユーザー」入力欄に「**講義棟**」と入力する。
3. 「お知らせ」を保存する。
### 「お知らせを固定表示」について
「お知らせを固定表示」にチェックを入れると、その「お知らせ」はホームの一番上に全文表示されます（上図）。また、「お知らせ」一覧では非表示になります。
「お知らせを閲覧可能なユーザー」と「お知らせを固定表示」の両方を設定した場合、「お知らせを閲覧可能なユーザー」としてログインしている場合のみ、ホームの一番上に「お知らせ」が全文表示されます。
# 学園祭参加企画にPDFなどのファイルを配布する
PortalDotsを使えば、学園祭に参加する企画向けの各種ファイルを配布することができます。
## 概要
PortalDotsの「配布資料」機能を利用することで、PortalDotsで構築した学園祭ウェブシステム上で「配布資料」を配布することができます。
「配布資料」機能で配布する資料として PDF の他、Word や Excel ファイル、画像ファイルなどをアップロードすることができます。
## 「配布資料」をアップロードする
1. 「スタッフモード」を開きます。
2. メニューから「配布資料管理」を選びます。
3. 「新規配布資料」を選びます。
4. 以下の表に記載されている入力欄が表示されます。入力欄に入力し終わったら「保存」を選びます。
| 入力項目 | 説明 |
| ------------- | ------------------------------------------------------ |
| ファイル | 「配布資料」として配布したいファイルをアップロードします。 |
| 配布資料名 | 「配布資料」のタイトルを入力します。 |
| 説明 | 「配布資料」の説明を入力します。 |
| 公開設定 | 「公開」にチェックを入れると配布資料が公開されます。「非公開」にチェックを入れると配布資料は公開されません。 |
| この配布資料は重要かどうか | 「重要」にチェックを入れると「配布資料」一覧の中で「配布資料」が強調して表示されます。 |
| スタッフ用メモ | 一般ユーザーには公開されないスタッフ用のメモを入力できます。 |
# 学園祭当日に使用できる場所の一覧や各企画への場所の割り当てを管理する
PortalDotsを使えば、学園祭当日に使用できる場所（教室や模擬店ブース）の一覧を管理できます。また、各企画ごとに場所を割り当てることもできます。
## 概要
PortalDotsの「場所情報管理」機能を利用することで、学園祭当日に各企画が利用することのできる場所の一覧を管理することができます。各場所はタイプ（屋内・屋外・特殊場所）別に分類することができます。また、各場所の特徴などをメモとして残しておくこともできます。
PortalDotsの「企画情報管理」機能では、各企画が使用する場所を登録することができます。各場所における企画の割り当て一覧をCSV形式で出力し、Excelで管理することもできます。
## 「場所」を登録する
1. 「スタッフモード」を開きます。
2. メニューから「場所情報管理」を選びます。
3. 「新規場所」を選びます。
4. 以下の表に記載されている入力欄が表示されます。入力欄に入力し終わったら「保存」を選びます。
| 入力項目 | 説明 |
| ------- | --------------------------------------------------------------- |
| 場所名 | 登録する場所の名前を入力します。模擬店の場合はブース名、教室の場合は教室名を入力するのがおすすめです。 |
| タイプ | 場所が「屋外」か「屋内」のどちらにあるのかを選択できます。どちらの分類にも当てはまらない場合は「特殊場所」を選択してください。 |
| スタッフ用メモ | 一般ユーザーには公開されないスタッフ用のメモを入力できます。 |
## 各企画に場所を割り当てる
PortalDotsに登録している企画情報には、それぞれの企画が使用する場所を割り当てることができます。企画に場所を割り当てることで場所の使用状況をPortalDots上で管理できるようになります。
また、各企画に所属しているメンバーがPortalDotsにログインすると、ホーム画面の「企画情報」欄に「使用場所」が表示されるようになります（上図）。これにより、各企画が使用する場所をPortalDots上で簡単に連絡できます。
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 場所を割り当てたい企画の✏️(編集)ボタンを選びます。
4. 「使用場所」欄に、「場所情報管理」で登録した場所の名前を入力します。
5. 「保存」を選びます。
## 各場所に割り当てられている企画の一覧をCSV形式でダウンロードする
PortalDotsに登録した「場所」の情報や、各場所を使用する「企画」の情報をCSV形式でダウンロードすることができます。
1. 「スタッフモード」を開きます。
2. メニューから「場所情報管理」を選びます。
3. 「CSVで出力(場所別企画一覧)」を選びます。
{% hint style="info" %}
「企画情報管理」ページでダウンロードできるCSVファイルにも、各企画の使用場所情報が含まれます。
「企画情報管理」ページでダウンロードできるCSVファイルは「企画ID」順で出力されるのに対し、「場所情報管理」ページでダウンロードできるCSVファイルは「場所ID」順で出力されます。
また、「場所情報管理」ページでダウンロードできるCSVファイルには、各場所ごとに設定した「スタッフ用メモ」の情報も含まれます。
{% endhint %}
# 学園祭参加企画からの各種申請をオンラインで受け付ける
PortalDotsを使えば、学園祭の参加企画から様々な申請を受け付けることができます。場所希望調査、公式パンフレット掲載情報申請、備品貸出申請などをオンラインフォームで受付できます。
## 概要
PortalDotsの「申請管理」機能を利用することで、学園祭参加企画からの各種申請を受け付けることができます。例えば、下記のような申請の受付に利用できます。
* 場所希望調査 (学園祭当日に利用したいブース・教室などの希望を調査)
* 公式パンフレット掲載情報申請 (学園祭の来場者に配布するパンフレットに掲載する企画の紹介文を入稿してもらう)
* 備品貸出申請 (学園祭実行委員会や生協などが保有する備品の貸し出し希望を調査)
* 車両入構申請 (学園祭当日、キャンパス内に入構する車両のナンバー情報などを受付)
{% hint style="warning" %}
申請フォームに回答できるのは、「登録受理状況」が「受理」となっている企画のみです。
企画参加登録の受付方法や「登録受理状況」を変更する方法は、「[PortalDots を使って企画参加登録を受け付ける](/features/circle-registration)」ページに記載しています。
{% endhint %}
## 「Googleフォーム」等のサービスとの違い
PortalDotsの申請フォームは、「Googleフォーム」等のフォーム作成サービスと同じ感覚で作成できます。しかし、PortalDotsの申請管理機能は、下記の点でGoogleフォーム等のサービスと異なります。
* ログイン機能により、他の企画になりすまして申請フォームに回答できない
* Googleフォームは、フォームへの回答にGoogleアカウントでのログインを必須にすることはできます。しかし、「どの企画の誰か」という情報までは認証できません。
* 申請フォームの回答受付期間を設定できる
* Googleフォームとは異なり、PortalDotsでは申請フォームの受付開始日と終了日を指定できます。
* 一度作成した回答は、申請フォームの受付期間内であれば簡単に編集できる
* Googleフォームの場合、回答を編集するためのURLを紛失すると回答を編集できなくなります。
## 申請フォームを作成する
1. 「スタッフモード」を開きます。
2. メニューから「申請管理」を選びます。
3. 「新規フォーム」を選びます。
4. 以下の表に記載されている入力欄が表示されます。入力欄に入力し終わったら「保存」を選びます。
5. フォームエディターが表示されます。申請フォームに表示したい入力欄などを設定してください。ここで設定した内容は即座に公開(公開設定がオンの場合)されます。
| 入力項目 | 説明 |
| -------------- | ---------------------------------------------------------------------------------------- |
| フォーム名 | 申請フォームの名前を入力します。例 : 「公式ウェブサイト掲載情報申請」 |
| 企画毎に回答可能とする回答数 | 通常は「1」にします。 |
| 受付開始日時・受付終了日時 | 申請フォームへの回答を受け付ける期間を入力します。受付期間中、各企画は何度でも回答を編集できます。 |
| 公開設定 | 申請フォームの設問や、過去に行った回答内容を、学園祭の企画担当者が確認できるようにするかを選択します。この設定がオフの場合、回答受付期間中であっても回答を作成・編集できません。 |
| フォームへ回答可能なユーザー | （後述） |
| フォームの説明 | 申請フォームについての説明を入力します。この情報は企画担当者に公開されます。回答時の注意点などを企画担当者に対して説明できます。 |
| 回答後に表示する内容 | フォームに回答した方に向けて表示するメッセージを設定できます。この内容は、回答したユーザーに自動で送信されるメールにも表示されます。 |
{% hint style="info" %}
フォームの入力欄(設問)を編集するには「フォームエディター」を利用します。「フォームエディター」の利用方法については、「[フォームエディターで申請フォームを作成する](/advanced/form-editor)」をご覧ください。
{% endhint %}
### 「フォームへ回答可能なユーザー」について
PortalDotsに登録されているユーザー全員に対してフォームを公開する必要がなく、一部のユーザーにだけ回答してほしいフォームがある場合、「フォームへ回答可能なユーザー」機能を使ってフォームに回答できるユーザーを制限できます。
例えば、「講義棟教室の電源使用申請」というフォームを、講義棟を利用する企画のメンバーに対してだけ公開したい場合、以下のように設定してください。
1. 予め「企画情報管理」で、講義棟を利用する企画の「企画タグ」入力欄に「**講義棟**」と入力しておく。
2. 「フォーム」作成画面にある「フォームへ回答可能なユーザー」入力欄に「**講義棟**」と入力する。
3. フォームを保存する。
## フォームに集まった回答を確認する
各企画から集めたフォームへの回答を確認するには、下記の手順を行います。回答一覧の確認画面では、集まった回答をCSVファイルとしてダウンロードすることもできます。
1. 「スタッフモード」を開きます。
2. メニューから「申請管理」を選びます。
3. 集まった回答を確認したいフォームにある、目のアイコン(回答一覧)ボタンを選びます。
4. フォームに集まった回答の一覧が表示されます。
## 回答が作成・編集されたときに送信されるメールについて
各企画がフォームに対して回答を作成・編集すると、下記のユーザーに回答確認メールが送信されます。
* 回答したユーザーが所属する企画のメンバー全員
* 回答したユーザーがPortalDots上で複数の企画に所属している場合、回答を作成した企画に対してのみメールが送信されます
* フォームを一番最初に作成したスタッフユーザー
{% hint style="info" %}
現時点では、これらのメールの送信を停止することはできません。
{% endhint %}
# 学園祭参加企画からのお問い合わせを受け付ける
学園祭参加企画からのお問い合わせを、PortalDots上のお問い合わせフォームで受け付けることができます。
## 概要
PortalDotsの「お問い合わせ」受付機能を利用することで、学園祭の参加企画からのお問い合わせをウェブフォームで受け付けることができます。
また、お問い合わせの内容に応じて送信先メールアドレスを振り分けることも可能です。
{% hint style="info" %}
お問い合わせフォームからお問い合わせを送信できるのは、PortalDotsにログイン中のユーザーのみです。
{% endhint %}
## 初期状態のお問い合わせフォーム
PortalDotsのお問い合わせフォームは、特段の設定を行うことなくすぐに使うことができます。
PortalDotsをインストール後の初期状態では、ユーザーからのお問い合わせは「実行委員会のメールアドレス」に届きます。「実行委員会のメールアドレス」は、PortalDotsのインストール時に設定したメールアドレスです。
## お問い合わせの内容に応じて送信先のメールアドレスを変える (お問い合わせ受付設定)
「お問い合わせ受付設定」を変更することで、ユーザーからのお問い合わせを内容によって振り分けることができます。例えば、「学園祭の公式ウェブサイトに関するお問い合わせ」と「オンライン開催に関するお問い合わせ」を、それぞれ別のメールアドレスで受信することができます。
お問い合わせ内容を選択させる上記のセレクトボックスをお問い合わせフォームに設置するには、次の手順を行います。
1. 「スタッフモード」を開きます。
2. メニューから「お問い合わせ受付設定」を選びます。
3. 「メールアドレスを追加」を選びます。
4. お問い合わせ内容の選択肢として表示される「項目名」と、その項目を選択したときの送信先となる「メールアドレス」を入力します。
5. 入力し終わったら「保存」を選びます。
{% hint style="info" %}
「保存」を選ぶと、ここで入力した「メールアドレス」に対して確認メールが送信されます。確認メールを受け取れていない場合、ユーザーからのお問い合わせを受け取ることができない可能性があります。メールアドレスの入力内容に間違いがないか確認してください。
{% endhint %}
# PortalDotsでできること(一般モード)
PortalDotsの基本機能のうち、学園祭の参加企画向けの機能について説明します。
一般モードには下記の機能があります。
## 企画参加登録
学園祭への参加登録を行うことができます。企画参加登録の受付期間に限り、参加登録の作成・提出を行うことができます。
{% hint style="info" %}
一般ユーザーが企画参加登録を行えるようにするには、予めスタッフモード内での設定が必要です。詳細は、「[PortalDotsを使って企画参加登録を受け付ける](https://github.com/portaldots/docs/blob/main/circles/circle-registration.md)」をご覧ください。
{% endhint %}
## お知らせの閲覧
学園祭の参加企画向けのお知らせを閲覧することができます。
{% hint style="info" %}
お知らせを作成・編集する方法については、「[学園祭参加企画向けのお知らせを掲載・メール配信する](https://github.com/portaldots/docs/blob/main/circles/pages.md)」をご覧ください。
{% endhint %}
## 配布資料の閲覧
学園祭の参加企画向けに配布されている資料(ファイル)を閲覧することができます。
{% hint style="info" %}
配布資料を作成・編集する方法については、「[学園祭参加企画にPDFなどのファイルを配布する](https://github.com/portaldots/docs/blob/main/circles/documents.md)」をご覧ください。
{% endhint %}
## 申請フォームへの回答
申請フォームに回答することができます。申請フォームの受付期間中であれば、回答済みの申請フォームを編集することもできます。
{% hint style="info" %}
申請フォームを作成・編集する方法については、「[学園祭参加企画からの各種申請をオンラインで受け付ける](https://github.com/portaldots/docs/blob/main/circles/forms.md)」をご覧ください。
{% endhint %}
## 学園祭実行委員会へのお問い合わせ
学園祭実行委員会に対してお問い合わせを送信することができます。お問い合わせフォームを送信するには、PortalDotsにログインしている必要があります。
{% hint style="info" %}
PortalDotsの機能のうち、学園祭の実行委員(スタッフ)が利用可能な機能については「[PortalDotsでできること(スタッフモード)](/features/list)」をご覧ください。
{% endhint %}
# 学園祭参加企画を手動でPortalDotsに登録・編集する
学園祭に参加する企画の情報をPortalDotsで管理するために、企画情報をPortalDotsに登録する方法を説明します。また、PortalDotsに登録されている企画情報を編集する方法を説明します。
## 企画情報を手動で登録する必要があるケース
手入力による企画情報の登録は手間がかかるため、PortalDotsでは「企画参加登録」機能を利用することを推奨しています。企画参加登録機能を使えば、各企画の担当者に企画情報を入力してもらうことができます。
それでも、下記の場合では企画情報を手動で登録した方が良いと考えられます。
* PortalDotsの企画参加登録機能以外の方法で企画参加登録を受け付けた場合
* 企画参加登録の受付期間外に、特別対応として企画参加登録を受け付けた場合
{% hint style="warning" %}
PortalDotsでは「企画」は手動で登録できますが「ユーザー」は手動で登録できません。企画に所属するメンバーを登録するには、そのメンバーに対して[PortalDotsのユーザー登録を完了するように依頼する](/setup/user-registration)必要があります。
{% endhint %}
{% hint style="info" %}
PortalDotsの企画参加登録機能の詳細については、「[PortalDotsを使って企画参加登録を受け付ける](/features/circle-registration)」をご覧ください。
{% endhint %}
## 企画情報の登録・編集方法
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 登録・編集したい企画の参加種別を選びます。参加種別を作成していない場合、まず参加種別を作成してください。
4. 企画を新しく登録する場合は「新規企画」を選びます。すでに登録されている企画情報を編集する場合は、編集したい企画の✏️(編集)ボタンを選びます。
5. 以下の表に記載されている入力欄が表示されます。入力欄に入力し終わったら「保存」を選びます。
| 入力項目名 | 説明 |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **企画基本情報** | 企画についての基本的な情報を入力するセクションです。 |
| 参加種別 | 企画の参加種別を選択します。参加種別が未作成の場合、企画の登録はできません。 |
| 企画名・企画名(よみ) | 企画の名前を入力します。 |
| 企画を出店する団体の名称・企画を出店する団体の名称(よみ) | 学園祭に出店する企画を行う団体の名前を入力します。 |
| 使用場所 | 企画が学園祭当日に利用する場所(教室・模擬店ブースなど)を選択します。「場所情報管理」機能で予め作成した場所から選択できます。
PortalDotsの「場所情報」機能の詳細は、「学園祭当日に使用できる場所の一覧や各企画への場所の割り当てを管理する」をご覧ください。
|
| カスタムフォームへの回答 | 「企画参加登録」機能で作成した独自のフォーム(入力欄)への入力内容を編集できます。
PortalDotsの「企画参加登録」機能の詳細は、「PortalDotsを使って企画参加登録を受け付ける」をご覧ください。
|
| タグ | 企画をタグで分類することができます(後述)。 |
| **企画のメンバー** | 企画の責任者・副責任者の情報を入力するセクションです。 |
| 責任者の学籍番号 | 企画の責任者の方の学籍番号を入力します。 |
| 学園祭係(副責任者)の学籍番号 | 企画の副責任者の方の学籍番号を入力します。複数の副責任者がいる場合、1行につき1つ学籍番号を入力でいます。 |
| **参加登録の受理設定** | 企画参加登録を受理したか取り下げたかを入力できるセクションです。この設定を変更すると、その企画のメンバーに対し、企画が受理された(されなかった)旨が記載されたメールが送信されます。 |
| 参加登録の受理設定 | 企画参加登録を受理するかどうかを選択できます(後述)。 |
| 不受理に関する詳細(ユーザーに通知) | (後述) |
| **スタッフ用メモ** | 一般ユーザーには公開されないスタッフ用のメモを入力できます。 |
### 「タグ」について
学園祭への参加形態などに応じて企画をタグで分類することができます。また、企画のメンバーが[閲覧できるお知らせを制限](/features/pages#orasewonayznitsuite)したり、[回答可能な申請フォームを制限](/features/forms#fmuhenayznitsuite)したりする目的でもタグを利用できます。
タグ入力欄では、半角スペースで区切ることで複数のタグを設定できます。例えば、講義棟内の教室で企画を出店する企画であり、物品の販売を伴う企画の場合、タグ入力欄では下記の画像のように入力するのがおすすめです。
{% hint style="info" %}
上記の画像の例では「講義棟」と入力していますが、「講義棟教室」などの他の表記でも構いません。ただし、全ての企画を通して表記を統一する必要があります。例えば「講義棟」タグと「講義棟教室」タグは全く別のタグであるとみなされます。
{% endhint %}
### 「参加登録の受理設定」について
企画参加登録を受理したか取り下げたかを設定できます。各企画について「確認中」「受理」「不受理」のうちから1つ設定できます。
| オプション | 説明 |
| ----- | -------------------------------------------------------------------------------------------------------------------------- |
| 確認中 | このオプションを選択すると、企画に所属しているメンバーに対して、企画参加登録の内容が確認中である旨が表示されます。
「企画参加登録」を提出した直後の企画は、全て自動的に「確認中」として設定されます。
|
| 受理 | 企画参加登録の内容を受け入れる場合、このオプションを選択します。
PortalDots「申請」機能で作成した申請フォームに回答できるのは、「受理」として設定されている企画のメンバーのみです。
|
| 不受理 | 企画参加登録を取り下げる場合、このオプションを選択します。
また、「不受理に関する詳細」欄に不受理とした理由を記載することもできます。「不受理に関する詳細」の内容は、不受理となったことを通知するメール内に表示されます。
|
{% hint style="info" %}
「登録受理状況」を「受理」または「不受理」にチェックを入れると、その企画のメンバーに対し、企画が受理された(されなかった)旨が記載されたメールが送信されます。
{% endhint %}
# フォームエディターで申請フォームを作成する
PortalDotsで公開する申請フォームを作成するには「フォームエディター」を利用します。企画参加登録フォームに独自の入力欄を作成する場合もフォームエディターを利用します。
## 概要
PortalDotsの「フォームエディター」を利用すると、プログラミング不要の直観的な操作で申請フォームを作成することができます。
{% embed url="" %}
フォームエディター
{% endembed %}
## フォームエディターを起動する
既に作成済みの申請フォームを編集したい場合や、企画参加登録フォームに追加した独自の入力欄（カスタムフォーム）を編集したい場合、次の方法でフォームエディターを起動することができます。
### 申請フォームを編集する
1. 「スタッフモード」を開きます。
2. メニューから「申請管理」を選びます。
3. 編集したいフォームの名前を選びます。
4. 画面上部の「エディター」タブを選びます。
### 企画参加登録フォームの独自の入力欄(カスタムフォーム)を編集する
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. カスタムフォームを編集したい参加種別を選びます。
4. 画面上部の「参加登録フォームの設定」タブを選びます。
5. 「フォームエディターを開く」を選びます。
## 設問(入力欄)をフォームに追加する
フォームエディターの画面右側にある「設問を追加」サイドバーから、フォーム内に設問(入力欄)を追加することができます。
| 設問タイプ | 説明 |
| -------------- | ---------------------------------------------------------------------------------- |
| セクション見出し | 複数の設問をセクションにまとめることができます。この設問タイプには入力欄がありません。見出しとして利用できるほか、フォーム内に説明文を表示する目的でも利用できます。 |
| 一行入力 | 1行だけ入力できる入力欄(テキストボックス)です。 |
| 整数入力 | 整数を入力できる入力欄(テキストボックス)です。数字以外の文字を入力することはできません。 |
| 複数行入力 | 入力内容に改行を含めることができる入力欄(テキストボックス)です。 |
| 単一選択(ラジオボタン) | 複数の選択肢から1つだけ選択できる入力欄です。 |
| 単一選択(ドロップダウン) | 複数の選択肢から1つだけ選択できる入力欄です。 |
| 複数選択(チェックボックス) | 複数の選択肢から2つ以上選択できる入力欄です。 |
| ファイルアップロード | ファイルをアップロードできる入力欄です。 |
## 設問を編集する
フォームエディターに追加した設問をクリックすると、その設問に関する情報を編集することができます。設定可能な項目は、設問タイプによって異なります。
### 全設問タイプ共通の設定項目 (セクション見出しを除く)
| 設定項目 | 説明 |
| ----- | ----------------------------------------------------- |
| 回答必須か | 回答を必須とする場合はオンにします。回答必須の設問が未回答の場合、申請フォームを提出することができません。 |
| 設問名 | 入力欄の名前として表示するテキストを入力します。 |
| 説明 | 入力欄の説明として表示するテキストを入力します。 |
### セクション見出し
| 設定項目 | 説明 |
| ---- | ---------------------- |
| 見出し | 見出しとして表示するテキストを入力します。 |
| 説明 | 見出しの下に表示されるテキストを入力します。 |
### 一行入力・複数行入力
| 設定項目 | 説明 |
| ----------- | -------------------- |
| 最小文字数・最大文字数 | 入力欄に入力できる文字数を制限できます。 |
### 整数入力
| 設定項目 | 説明 |
| ------- | --------------------------- |
| 最低数・最大数 | 入力欄に入力できる数値の最小値・最大値を制限できます。 |
### 単一選択(ラジオボタン)・単一選択(ドロップダウン)
| 設定項目 | 説明 |
| ---- | ------------------------------------------------------- |
| 選択肢 | 選択肢として表示する内容を入力します。複数の選択肢から選択させる場合、1行につき選択肢を1つ入力してください。 |
### 複数選択(チェックボックス)
| 設定項目 | 説明 |
| ----------- | ------------------------------------------------------- |
| 選択肢 | 選択肢として表示する内容を入力します。複数の選択肢から選択させる場合、1行につき選択肢を1つ入力してください。 |
| 最小選択数・最大選択数 | チェック可能な数を制限できます。 |
### ファイルアップロード
| 設定項目 | 説明 |
| --------- | -------------------------------------------------------------------------- |
| 最大サイズ(KB) | アップロード可能なファイルサイズをキロバイト(KB)単位で制限できます。 |
| 許可される拡張子 | アップロード可能なファイルの拡張子を指定できます。**「許可される拡張子」が未設定の場合、ユーザーはファイルをアップロードすることができません。** |
# Markdownガイド
このページでは、Markdown記法のうち、よく利用されるものを紹介します。
## Markdownについて
PortalDotsでは、お知らせの本文などをMarkdown記法で書くことができます。PortalDotsでMarkdown記法を使える入力欄には、下記のように「Markdown」と表示されています。
## 見出し
行の先頭に `#` 記号と半角スペースを入れると、その行は見出しとなります。 `#` の数が多いほど小さな見出しになります。
```
# これは大きい見出し(h1)です
## これは見出し(h2)です
### これは見出し(h3)です
#### これは見出し(h4)です
##### これは見出し(h5)です
###### これは見出し(h6)です
```
上記のように書くと、下記のように表示されます。
## 箇条書き
行の先頭に `*` 記号と半角スペースを入れると、その行は箇条書きとなります。 \* の前に半角スペースを2つ以上入れると段下げできます。
```
* 箇条書き1
* 箇条書き2
* 箇条書き2-1 — * の前に半角スペースを2つ以上入れると段下げできます
* 箇条書き2-2
* 箇条書き3
```
上記のように書くと、下記のように表示されます。
## 番号付きリスト
行の先頭に `1.` と半角スペースを入れると、その行は箇条書きとなります。 `1.` の前に半角スペースを2つ以上入れると段下げできます。
```
1. 最初の項目
1. 次の項目
1. 子項目a — 1. の前に半角スペースを2つ以上入れると段下げできます
1. 子項目b
1. 最後の項目
```
上記のように書くと、下記のように表示されます。
## 太字
太字にしたい部分を `**` 記号で囲みます。
```
**ここ**が太字になります
```
**ここ**が太字になります
## 取り消し線
取り消し線を引きたい部分を `~~` 記号で囲みます。
```
~~ここ~~に取り消し線を引きます
```
~~ここ~~に取り消し線を引きます
## リンク
下記のように、 `[リンクとして表示する文字](URL)` という形でリンクを作成できます。
```
[ここをクリック](https://www.portaldots.com)するとPortalDotsのウェブサイトにアクセスします
```
[ここをクリック](https://www.portaldots.com)するとPortalDotsのウェブサイトにアクセスします
## 引用
行の先頭に `>` と半角スペースを入れると、その行は引用の表示となります
```
> 一人ひとりの「想い」をつなぎ、学園祭を最高に楽しくする
```
> 一人ひとりの「想い」をつなぎ、学園祭を最高に楽しくする
## 表(テーブル)
```
| 列1 | 列2 | 列3 |
| --- | --- | --- |
| John | Doe | Male |
| Mary | Smith | Female |
```
# PortalDotsのアップデート
セキュリティのため、PortalDotsは定期的にアップデートすることをおすすめします。
## PortalDotsのアップデートを行う
PortalDotsのアップデートを行うには、以下の手順に従ってください。
1. 「スタッフモード」を開きます。
2. メニューから「PortalDotsのアップデートの確認」を選びます。
3. アップデートが可能な場合、PortalDotsをアップデートする方法が表示されます。画面の指示に従ってPortalDotsをアップデートしてください。
{% hint style="warning" %}
メジャーバージョンをまたぐアップデート（PortalDots 4からPortalDots 5へのアップデートなど）はできません。メジャーバージョンをまたいでアップデートした場合、PortalDotsは動作しません。
{% endhint %}
## アップデート後、PortalDotsが開けなくなった場合
アップデートを行ったことでPortalDotsを開けなくなってしまった場合、以下の記事を参照してPortalDotsを再インストールしてください。
{% content-ref url="/pages/Q7I3FLo0DQ1X0JxyaQMA" %}
[PortalDotsを開けなくなったとき（PortalDotsの再インストール）](/settings/cannot-open)
{% endcontent-ref %}
# PortalDotsを開けなくなったとき（PortalDotsの再インストール）
画面が真っ白になったり、エラーが表示されたりしてPortalDotsを開けなくなった場合の対処法をご説明します。
PortalDotsを開いた際、以下のような症状が発生した場合は、PortalDotsを再インストールすることで問題が解決する可能性があります。
* 画面が真っ白になる。
* サーバーエラーと表示され、PortalDotsの機能が利用できない。
PortalDotsを再インストールするには、以下の手順に従ってください。
{% hint style="info" %}
このページに記載の方法で再インストールすることで、データを削除することなくPortalDotsを再インストールできます。
{% endhint %}
## PortalDotsを再インストールする
PortalDotsを再インストールするには、以下の手順に従ってください。
1. FTPソフト（Cyberduckなど）で、PortalDotsをインストールしたサーバーに接続します。
2. 現在サーバー上にあるPortalDots関連ファイルを、すべてお使いのコンピューターにダウンロードします（バックアップ）。
* 最低でも以下のファイルはダウンロードする必要があります。
* `.env` ファイル（PortalDotsインストーラーなどで設定したPortalDotsの設定が保存されています）
* `storage` フォルダー内の `app` フォルダー（配布資料、および申請フォームにアップロードされたファイルが保存されています。必ずダウンロードしてください）
* （ロリポップ！レンタルサーバーをご利用の場合のみ） `cron` フォルダー内の `lolipop.sh` ファイル（このファイルが存在しない場合はダウンロード不要）
3. サーバー上のPortalDots関連ファイルをすべて削除します。
* 必ず、上記 `2.` の作業を行った後に行ってください。
* ユーザー情報、企画情報、場所情報、お知らせ、配布資料（ファイル本体以外の情報）、申請フォームとその回答、お問い合わせ受付設定、スタッフの権限設定はデータベース上に保存されています。FTPソフトでファイルを削除しても、これらの情報は削除されませんのでご安心ください。
4. PortalDotsの最新版をダウンロードします。
* 現在お使いのPortalDotsのバージョンに合わせて、以下のURLからPortalDotsをダウンロードしてください。
* [PortalDots 5を利用中の場合](https://releases.portaldots.com/downloads/latest.zip?major_version=5)
* [PortalDots 4を利用中の場合](https://releases.portaldots.com/downloads/latest.zip?major_version=4)
5. `4.` でダウンロードしたZIPファイルを展開し、FTPソフトでサーバーにアップロードします。
6. `5.` でアップロードしたファイルのうち、 `.env` ファイル、 `storage` フォルダー内の `app` フォルダー、`cron` フォルダー内の `lolipop.sh` ファイル（存在する場合のみ）を、 `2.` でダウンロードしたファイルで上書きアップロードします。
7. PortalDotsにアクセスし、正常に動作するか確認してください。
## 再インストール後、エラーが表示された場合
再インストール後、「データベース接続エラー」などのエラーが表示された場合、以下の手順に従ってください。
{% hint style="warning" %}
この手順を実施すると、PortalDotsの設定（ポータルの名前、MySQLデータベース設定、メール配信の設定など）は削除されるため、再設定が必要になります。この場合でも、データベース上に保存されているデータは削除されません。
{% endhint %}
1. FTPソフトでアップロードしたファイルのうち `.env` ファイルを削除します。
2. PortalDotsにアクセスし、PortalDotsのインストーラーが起動することを確認します。
3. PortalDotsのインストーラーで、PortalDotsの設定を行います。
* 「管理者ユーザーの作成」画面では、今までPortalDotsに登録したことがないユーザーの情報を入力する必要があります（このユーザーは管理者として登録されますのでご注意ください）。
# PortalDotsの開発に貢献する
PortalDotsの開発に興味を持ってくださりありがとうございます。PortalDotsはGitHub上で公開しているオープンソースプロジェクトです。プロジェクトをより良くするための提案（不具合報告・改善案・Pull Request）などがありましたらぜひお寄せください。
PortalDotsでは、「作る人」と「使う人」という関係性に留まらず、みんなでPortalDotsを盛り上げていく形が理想だと思っています。みなさまのご協力をよろしくお願いいたします。
## 貢献の方法
PortalDotsにおける改善要望・不具合報告、Pull Requestの作成方法や取り扱いについては、[コントリビューションガイドライン](https://github.com/portaldots/PortalDots/blob/5.x/CONTRIBUTING.md)をご覧ください。
{% hint style="info" %}
PortalDotsマニュアル(このサイト)は、PortalDotsソフトウェア本体と同様、GitHub上で公開しているオープンソースプロジェクトです。詳細は、[「PortalDotsマニュアル」の作成に貢献する](/contributing/how-to-contribute-to-docs)をご覧ください。
{% endhint %}
## 関連リンク
* [PortalDotsのGitHubリポジトリ](https://github.com/portaldots/PortalDots)
* [README](https://github.com/portaldots/PortalDots#readme)
* [コントリビューター行動規範](https://github.com/portaldots/PortalDots/blob/5.x/CODE_OF_CONDUCT.md)
* [コントリビューションガイドライン](https://github.com/portaldots/PortalDots/blob/5.x/CONTRIBUTING.md)
* [Issues](https://github.com/portaldots/PortalDots/issues)
* [Pull requests](https://github.com/portaldots/PortalDots/pulls)
* [Discussions (フォーラム)](https://github.com/portaldots/PortalDots/discussions)
* [ライセンス(MIT License)](https://github.com/portaldots/PortalDots/blob/5.x/LICENSE)
# PortalDotsのディレクトリ構造
PortalDotsを構成するディレクトリ構造を説明します。
[PortalDotsのGitHubリポジトリ](https://github.com/portaldots/PortalDots)は、以下のディレクトリ構造を持ちます(2023年5月現在)。
PortalDotsは、主にLaravelとVue.js(バージョン3)、SCSSを利用しています。
{% hint style="warning" %}
Laravelのモデルは、一般的に`app/Models`ディレクトリに格納しますが、PortalDotsでは`app/Eloquents`ディレクトリに格納しています。
{% endhint %}
```
.
├── .github
│ ├── workflows CIの実行やリリースZIPファイルの作成のためのGitHub Actionsワークフロー。
├── app Laravelのアプリケーションディレクトリ。
│ ├── Auth
│ ├── Console
│ ├── Eloquents モデル。Laravel標準のフォルダ(Models)とは異なるので注意。
│ ├── Exceptions
│ ├── Exports CSVエクスポート/インポート機能。
│ ├── GridMakers スタッフモード内に表示する各種一覧表示の定義。
│ ├── Http
│ │ ├── Controllers コントローラー。原則として1コントローラにつき1アクションのみ。
│ │ ├── Middleware
│ │ ├── Requests フォームリクエストクラス。バリデーション処理は原則ここに書く。
│ │ └── Responders
│ ├── Mail
│ ├── Notifications
│ ├── Policies
│ ├── Providers
│ └── Services サービスクラス。データベースを操作する処理をここに書くことがある。
├── bootstrap
├── config
├── cron
├── database
│ ├── factories
│ ├── migrations
│ └── seeders
├── docker_dev
├── patches npmパッケージにパッチを当てるために利用。
├── resources
│ ├── img
│ ├── js
│ │ ├── forms_editor フォームエディター用のJavaScriptファイル。Vue.jsを使用。
│ │ └── v2 フォームエディター以外のJavaScriptファイル。Vue.jsを使用。
│ ├── lang
│ ├── sass
│ │ └── v2 主なスタイルはこのフォルダ内に書く。
│ └── views ビューファイル。原則としてコントローラのアクション1つにつき1ファイル。
└── routes ルーティング定義ファイル。スタッフモードと一般モードでファイルを分けている。
```
# 「PortalDotsマニュアル」の作成に貢献する
「PortalDotsマニュアル」(このサイト)のコンテンツ作成・維持管理にご協力お願いいたします。
「PortalDotsマニュアル」の改善に興味を持ってくださりありがとうございます。
「PortalDotsマニュアル」は、PortalDotsの使い方を紹介するウェブサイトです。「PortalDotsマニュアル」のコンテンツはPortalDots本体と同様、[オープンソース](https://github.com/portaldots/docs/blob/main/LICENSE/README.md)です。コンテンツはMarkdown形式で管理しています。また、コンテンツ改善案や追加の要望を、GitHubのPull Request機能にて受け付けております。
PortalDotsコミュニティの発展のため、マニュアルの作成・維持管理に協力いただけますと幸いです。
{% hint style="info" %}
PortalDotsマニュアルのウェブサイトは、[GitBook](https://www.gitbook.com)(Communityプラン)上でホストしています。
{% endhint %}
## 既存の記事の内容を修正を提案する
GitHubのPull Request機能により、既存の記事内容の改善提案を受け付けております。
1. (パソコンの場合)改善提案を作成したい記事の画面右側に表示されている「GitHubで編集」をクリックします。(スマートフォンの場合)画面右上にある…をタップし、「GitHubで編集」を選択します。
2. GitHubリポジトリ上の当該記事ファイルが表示されます。 "Edit this file" を選択してください。
3. コンテンツ内容を修正します。
4. 画面下部の "Commit changes" にて変更内容の説明を記載し、Pull Requestを作成してください。
## 新しい記事の追加を提案する
PortalDotsマニュアル上に存在しないページの作成を提案したい場合は、「[マニュアル記事の新規作成提案(GitHub)](https://github.com/portaldots/docs/tree/main/5.x/_drafts)」をご覧ください。
{% hint style="warning" %}
`_drafts` フォルダ以外のフォルダへのページ作成は受け付けていません。
{% endhint %}
# PortalDots 4
PortalDots マニュアルへようこそ！PortalDotsを使えば、学園祭運営に欠かせないさまざまな業務を、より効率的に実施できます。
{% hint style="danger" %}
**これはPortalDots 4のマニュアルです。**
最新版のPortalDotsをご利用の場合は、[最新版のマニュアル](https://docs.portaldots.com)をご利用ください。
{% endhint %}
## マニュアルの目次
### よくある質問
PortalDotsを学園祭実行委員会に導入するにあたり、よくある質問をご紹介します。
{% content-ref url="/pages/xOvH6bxN3UAzxwyZ1TBk" %}
[よくある質問](/4.x/faq)
{% endcontent-ref %}
### PortalDotsの導入
PortalDotsはWordPressなどのソフトウェアのように、レンタルサーバーにインストールして利用できます。ここでは、レンタルサーバーにPortalDotsをインストールする方法をご説明します。
{% content-ref url="/pages/7sY5qTneTlMHPPeACCWo" %}
[PortalDotsのインストール](/4.x/setup/install)
{% endcontent-ref %}
PortalDotsのインストールが完了したら、学園祭参加企画の担当者と学園祭実行委員会のメンバーにもPortalDotsのユーザー登録をしてもらいましょう。
{% content-ref url="/pages/SL6B2hDldmTobawAN4Yo" %}
[PortalDotsのユーザー登録をしてもらう](/4.x/setup/user-registration)
{% endcontent-ref %}
### 基本機能
PortalDotsの基本機能と、それらの使い方をご紹介します。
{% content-ref url="/pages/TvKkqJxzz7bprd4WVjNi" %}
[「一般モード」と「スタッフモード」](/4.x/features/modes)
{% endcontent-ref %}
{% content-ref url="/pages/JqY4U5Ymk3WETp8kbDU8" %}
[PortalDotsでできること(スタッフモード)](/4.x/features/list)
{% endcontent-ref %}
### 学園祭参加企画向けの機能
PortalDotsの機能のうち、学園祭の参加企画向けの機能をご紹介します。
{% content-ref url="/pages/buU00Tc1dcX4HKBscSX3" %}
[PortalDotsでできること(一般モード)](/4.x/circles/list)
{% endcontent-ref %}
### もっと使いこなす
{% content-ref url="/pages/PuLHvRZnT0AoqY1Zkdgz" %}
[学園祭参加企画を手動でPortalDotsに登録・編集する](/4.x/advanced/manual-circle-registration)
{% endcontent-ref %}
{% content-ref url="/pages/1wxzrbIQNAjURHX94qds" %}
[フォームエディターで申請フォームを作成する](/4.x/advanced/form-editor)
{% endcontent-ref %}
{% content-ref url="/pages/SEDv1U5xb6dk5Qz44tuB" %}
[Markdownガイド](/4.x/advanced/markdown-guide)
{% endcontent-ref %}
### 開発に貢献する
{% content-ref url="/pages/HAhZH7YwHOQw8VlNIQAL" %}
[PortalDotsの開発に貢献する](/4.x/contributing/how-to-contribute)
{% endcontent-ref %}
{% content-ref url="/pages/me9OvfZmO3DdcJp0uQIE" %}
[PortalDotsのディレクトリ構造](/4.x/contributing/directories)
{% endcontent-ref %}
{% content-ref url="/pages/iI4KaDw5EqusfyYRqclg" %}
[「PortalDotsマニュアル」の作成に貢献する](/4.x/contributing/how-to-contribute-to-docs)
{% endcontent-ref %}
# よくある質問
## 🤔 PortalDots について
Q. PortalDots とは何ですか?
**A. 学園祭の運営をサポートする、学園祭実行委員会向けのウェブシステムです。**
具体的には、こんなことができます（一例）。
* 学園祭に参加するサークルの方へお知らせメールを一斉配信できます
* 各種申請(参加登録、利用ブースの希望調査、車両入構申請など)の受付をオンラインで行うことができます
* 各種申請フォームは、Google フォームのように直感的に作成できます
* ウェブシステムには学生のみがユーザー登録・ログインできるため、セキュリティを確保できます
* それぞれの参加サークルが利用する教室・ブースなどの場所を管理できます
Q. PortalDots は誰が作っているのですか?
**A. 開発は東京理科大学の学園祭実行委員経験者が主導するボランティアの開発チームによって行っています。**
PortalDots は元々、学園祭実行委員会の内部で構築したウェブシステムでした。このウェブシステムを多くの学園祭に使っていただきたいと思い、PortalDots という名前で一般公開することにしました。
Q. PortalDots の開発は誰でも関われますか?
**A. はい、大歓迎です！**
PortalDots のプログラムは [GitHub 上で公開](https://github.com/portaldots/PortalDots)しています。
技術的な話になりますが、要望やバグ報告の Issue やプログラム改修依頼の Pull Request という形で PortalDots の開発に貢献していただけます。
## 💰 費用について
Q. PortalDots は無料で利用できますか?
**A. はい、PortalDots のソフトウェア本体は無料で利用できます。ただし、PortalDots を利用するには別途ウェブサーバーが必要です。**
PortalDots は無料で提供しており、どなたでも自由にご利用いただけます。ただし、PortalDots 開発チームが提供するのはPortalDots のプログラムコードのみとなります。実際に PortalDots を利用するには、PortalDots をインストールするためのウェブサーバーが必要です。これは、WordPress などと同様の仕組みです。
Q. ウェブサーバーはどのように用意すれば良いでしょうか?
**A. PortalDots は一般的な「WordPress 対応レンタルサーバー」に対応しています。**
PortalDots は WordPress に対応したレンタルサーバーにインストールすることができます。具体的には、PHP 7.3 以上かつ MySQL 5.7 以上を搭載したサーバーに対応しています。
Q. レンタルサーバーの費用はどのくらいかかりますか?
**A. 年間 5,000 円〜10,000 円程度のサービスが多いと思います。**
PortalDots をインストール可能なレンタルサーバー（PHP 7.3 以上、MySQL 5.7 以上を搭載）の価格帯は、おおむねこの金額になるかと思います。
なお、同じレンタルサーバーサービスであっても、一番価格が低いプランでは PortalDots を利用できないことがありますのでご注意ください。
## 🛠 初期設定について
Q. PortalDots の導入に専門的な知識は必要ですか?
**A. あまりパソコンに詳しくない場合は、パソコンに詳しい人に導入を頼んでみてください。**
PortalDots は、「登録したらすぐ使えるサービス」ではありません。レンタルサーバーの契約、FTP ソフトの利用方法などにおいて、ある程度 IT に関する知識が必要になります。
とはいえ、プログラミングの知識は必要ありません。[セットアップ方法のマニュアル](/4.x/setup/install)では、手順通りに作業を行うことで PortalDots を導入することができるよう、できる限り詳細に説明しています。
Q. PortalDots はどうやって導入するのでしょうか?
**A. PortalDots に対応したレンタルサーバーを契約し、そのサーバーにインストールすることで導入できます。**
参考として、PortalDots 公式サイトでは[ロリポップ！レンタルサーバー](/4.x/setup/install/lolipop)、[コアサーバー](/4.x/setup/install/coreserver)に PortalDots をインストールする方法を紹介しています。
また、これら以外のレンタルサーバーでも、おおむね下記の方法で PortalDots をインストールすることができます。
1. PHP 7.3 以上、MySQL 5.7 以上、Apache (または LiteSpeed) に対応したサーバーを用意する
2. サーバー提供会社のマニュアルを参考に、メールサーバーやデータベースサーバーの設定（ホスト名、パスワード、ポート番号など）を確認する
3. [PortalDots をダウンロード](https://www.portaldots.com/download/) し、ZIP ファイルを展開する
4. FTP ソフトなどを利用して PortalDots をサーバーへアップロードする
5. アップロードした PortalDots の URL にアクセスし、表示されるインストーラーの指示に従う
6. インストールが完了したら、メール配信を利用できるように CRON の設定をする (レンタルサーバー会社によって設定方法が異なります。詳細は [PortalDots の LINE 公式アカウント](https://lin.ee/aeee9s9) までお問い合わせください)
## 💻 運用について
Q. PortalDots はどのように使えば良いでしょうか?
**A. まずは、各サークルの学園祭担当者に PortalDots のユーザー登録をしてもらいましょう。**
PortalDots を使ってお知らせメールを配信したり、各種申請を受け付けたりするには、各サークルの方に PortalDots へのユーザー登録をしていただく必要があります。
ユーザー登録では学籍番号の入力が必要なため、学外のユーザーが学園祭に参加登録することを防ぐことができます。また、ユーザー登録していただいたユーザーに対してお知らせメールを配信したり、各種申請フォームへの入力をお願いしたりすることができます。
Q. お知らせや各種申請フォームを、各担当の実行委員に作ってもらうには?
**A. 実行委員の方にも PortalDots のユーザー登録をしてもらいましょう。**
お知らせや各種申請フォームの作成は、PortalDots の「スタッフモード」で行うことができます。
まずは実行委員に PortalDots のユーザー登録をしてもらいます。その後、管理者ユーザーがそのユーザーを「スタッフ」として登録することで、PortalDots の「スタッフモード」が利用可能になります。
Q. ユーザー登録の方法や「スタッフ」登録の方法を知りたい
**A. 「**[**PortalDots のユーザー登録をしてもらう**](/4.x/setup/user-registration)**」ページをご覧ください。**
Q. 作成した申請フォームがユーザーに表示されない!
**A. 下記をご確認ください。**
* **申請フォームに回答できるのは、「登録受理状況」が「受理」となっている企画のみです。**
* 企画参加登録の受付方法や「登録受理状況」を変更する方法は、「[PortalDots を使って企画参加登録を受け付ける](/4.x/features/circle-registration)」ページに記載しています。
* **申請フォームは公開状態になっていますか?**
* 申請フォームは、ユーザーに対して公開するかどうかを設定できます。申請フォームの設定をご確認ください。
## ❓ その他
Q. PortalDots についてわからないことがあるときは?
**A. PortalDots 開発チームまでお気軽にお問い合わせください！**
[PortalDots の LINE 公式アカウント](https://lin.ee/aeee9s9) では、PortalDots のセットアップ方法や利用方法に関する質問を受け付けております(無料)。ぜひご活用ください。
※PortalDots 開発チームはボランティアによる活動です。LINE でのサポートは解決を保証するものではありません。予めご了承ください。
# PortalDotsのインストール
ここでは、レンタルサーバーにPortalDotsをインストールする方法を説明します。
{% content-ref url="/pages/kqCvAZwpR7b7yHilZbVP" %}
[ロリポップ！レンタルサーバーに PortalDotsをインストールする](/4.x/setup/install/lolipop)
{% endcontent-ref %}
{% content-ref url="/pages/e2MEAeazG5zMGV5bM2Pa" %}
[コアサーバーに PortalDotsをインストールする](/4.x/setup/install/coreserver)
{% endcontent-ref %}
# ロリポップ！レンタルサーバーに PortalDotsをインストールする
ロリポップ！レンタルサーバーに PortalDotsをインストールする方法をご説明します。
{% hint style="info" %}
ここでは、PortalDots 3 以上について説明しています。PortalDots 1 はさくらのレンタルサーバーでのみ動作します。
{% endhint %}
## 「ロリポップ！レンタルサーバー」で PortalDots を利用するメリット・デメリット
* 「ロリポップ！レンタルサーバー」では、利用料金の支払いにクレジットカード決済のほか、銀行振替やコンビニ決済が利用できます。
## このマニュアルで説明する内容
* FTP 接続ソフトとして Cyberduck を使用する前提で説明します。
* レンタルサーバー申し込み時に決める URL を、PortalDots の URL としてそのまま利用する前提で説明します。
* 独自ドメインを利用したい場合や、1 つのロリポップ！レンタルサーバーの契約で PortalDots 以外のウェブサイトも設置したい場合のセットアップ方法は、このページでは説明しません。
* レンタルサーバー申し込み時に自動で作成されるメールアドレスを、PortalDots から自動配信されるメールの差出人としてそのまま利用する前提で説明します。
* PortalDots から自動配信するメールの差出人のメールアドレスをカスタマイズしたい場合のセットアップ方法は、このページでは説明しません。
では早速、以下の「ステップ1」をクリックし、PortalDots のインストール方法を見ていきましょう。
# ステップ1. ロリポップ！レンタルサーバーに申し込む（無料お試しあり）
まずはPortalDotsをインストールするレンタルサーバーを申し込みましょう。
※無料お試しは、お支払い方法の入力は不要です。
1. [ロリポップ！レンタルサーバー](https://lolipop.jp)のウェブサイトにアクセスします
2. 「ご利用料金」ページへアクセスし、「ライト」プランの「10日間無料でお試し」をクリックします
* PortalDotsの動作は、最低でも「ライト」プランの契約が必要です（エコノミープランでは動作しません）。
* PortalDots以外のウェブサイトをロリポップ！レンタルサーバー上に設置することを検討している場合、複数のデータベースを利用できる「スタンダード」プラン以上の利用が向いているかもしれません。
3. 「ロリポップ！のドメイン」で、PortalDotsのURLを決めます
* ロリポップ！レンタルサーバー上で PortalDots以外のウェブサイトの設置を検討している場合、学園祭実行委員会の英語名などをURLにすることをお勧めします（本ページでは複数ウェブサイトをロリポップ！レンタルサーバー上に設置する場合のPortalDotsインストール方法は説明しません）
4. 「パスワード」を決め、「連絡先メールアドレス」を入力します
* 「ロリポップ！のドメイン」と「パスワード」は、「ロリポップ！ユーザー専用ページ」にログインする際に必要ですのでご留意ください。
5. 「SMS認証」や「お申し込み内容入力」など、ロリポップ！レンタルサーバー申し込みに必要な手続きを進めます
6. ロリポップ！レンタルサーバーへの申し込みが完了したら、次の「2. データベースを作成する」へ進みます
{% hint style="warning" %}
パスワードの使い回しや複数人での共有は危険です。\
PortalDots上ではユーザーの個人情報を多く扱うことになります。ロリポップ！レンタルサーバーのパスワードが漏洩すると、ユーザーの個人情報が流出する恐れがありますので、パスワードの取り扱いには十分ご注意ください。
{% endhint %}
# ステップ2. データベースを作成する
PortalDots上に保存するデータ（ユーザー情報や参加企画情報など）は、データベース上に保存されます。PortalDotsのインストール前に、あらかじめデータベースを作成しておきます。
1. 「ロリポップ！ユーザー専用ページ」にログインします
* ロリポップ！レンタルサーバーの申し込み時に入力した「ロリポップ！のドメイン」と「パスワード」でログインできます。
2. 画面左のメニューから「サーバーの管理・設定」を選び、「データベース」をクリックします
3. 「作成」ボタンをクリックします
4. 「データベース名」と「接続パスワード」は任意のものを設定します。ここで入力したデータベース名と接続パスワードは、PortalDotsをインストールする際に必要です。
5. 「作成」ボタンをクリックします。
6. データベース情報ページが表示されます。表示された「**サーバー**」「**データベース名**」「**ユーザー名**」「**パスワード**」を確認、メモします。
* 「パスワード」は、「パスワード確認」ボタンをクリックすると表示されます。
{% hint style="warning" %}
「接続パスワード」は、他の用途で利用していないパスワードを設定してください。このパスワードが漏洩すると、PortalDotsに保存されたユーザー情報が全て漏洩します。接続パスワードを忘れてしまった場合でも、ロリポップ！ユーザー専用ページ上で再度確認できますので、必ずランダムな文字列をパスワードとして設定してください。
{% endhint %}
# ステップ3. メールサーバーを確認する
PortalDotsでは、ユーザーへメールを自動送信するために、ロリポップのメールサーバー情報が必要になります。PortalDotsからのメルマガの配信を予定していない場合でも、メールサーバーの設定は必須です。
1. 「ロリポップ！ユーザー専用ページ」にログインします
2. 画面左のメニューから「メール」を選び、「メール設定／ロリポップ！webメーラー」をクリックします
3. メールアドレス一覧表の「メール設定」の列にある「確認・変更」ボタンをクリックします
4. 「メール情報」にある「**メールアドレス**」「**SMTP メールサーバー** (smtp.lolipop.jp)」「**ポート番号**」「**メールアカウント**」「**メールパスワード**」を確認、メモします。これらの情報は、PortalDotsをインストールする際に必要です。
* 「メールパスワード」は、「••••••••••」が表示されている箇所をクリックすると表示されます。
{% hint style="warning" %}
「メールパスワード」が漏洩すると、第三者が PortalDots のシステムになりすましてメールを送信することが可能になります。必ずランダムな文字列をパスワードとして設定してください。
{% endhint %}
# ステップ4. PortalDotsをサーバーにアップロードする
データベースとメールサーバーの確認ができたら、いよいよPortalDotsをサーバーへアップロードします。
{% hint style="info" %}
ブラウザ上で利用できる「ロリポップ！FTP」では PortalDotsをアップロードできません
{% endhint %}
1. 「ロリポップ！ユーザー専用ページ」にログインします
2. 画面左のメニューから「ユーザー設定」を選び、「アカウント情報」をクリックします
3. 「サーバー情報」にある「**FTPSサーバー**」「**FTP・WebDAVアカウント**」「**FTP・WebDAVパスワード**」を確認、メモします
* 「FTP・WebDAVパスワード」は、「表示」ボタンを押すと確認できます。
4. FTPソフトでFTP接続します。FTPソフトをインストールしていない場合、Cyberduckがお勧めです。設定方法はロリポップ！レンタルサーバーのサポートページに掲載されています([Macの場合](https://lolipop.jp/manual/hp/m-cyberduck/) / [Windowsの場合](https://lolipop.jp/manual/hp/w-cyberduck/))。
* Cyberduckの場合、「環境設定」内の「ブラウザ」タブにある「'.'で始まるファイルを表示」にチェックを入れてください\
5. 初期状態では welcome.html というファイルが設置されています。不要なため、welcome.html を右クリックして削除します。
6. [PortalDots.zip](https://github.com/portaldots/PortalDots/releases/latest/download/PortalDots.zip) をダウンロードし、展開します。
7. 展開してできたフォルダの中身を全てアップロードします。Cyberduckの場合、Finder(macOSの場合)またはエクスプローラー(Windowsの場合)からファイルをドラッグ&ドロップしてください。
* 隠しファイル(ドットで始まるファイル)も含めてアップロードしてください。macOS や Linux などの OS では、デフォルトではこれらのファイルは非表示になっています。macOS の場合、Finder で Command + Shift + . を押すと隠しファイルが表示されます。\
8. アップロードには5分〜10分程度時間がかかりますので、お待ちください。
9. アップロードが完了したら、ロリポップのユーザー専用ページ上部に表示されている「ロリポップ！のドメイン」のURLにアクセスします。この際、URLの先頭に「https\://」をつけてアクセスしてください。
* 「ロリポップ！のドメイン」が「 〇〇.capoo.jp 」の場合、「 [https://〇〇.capoo.jp](https://xn--w6ja.capoo.jp) 」にアクセスしてください。
10. 「PortalDotsへようこそ！」という画面が表示されたら、アップロード完了です。
# ステップ5. PortalDotsのインストール作業を進める
ウェブシステムの名前や、ここまでで確認してきたデータベースやメールサーバーの設定を行います。
「PortalDotsへようこそ！」画面にある「設定をはじめる」をクリックします。
## 5.1. 「ポータルの情報」設定
「ポータルの情報」画面では、以下のように設定します。
| 設定項目 | 説明 |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ポータルの名前 | ウェブシステムの名前を設定します。例えば「門点祭ウェブシステム」など、「〇〇祭ウェブシステム」という名前がお勧めです。 |
| ポータルのURL | ロリポップのユーザー専用ページ上部に表示されている「ロリポップ！のドメイン」の先頭に、「https\://」を追加したものを入力してください。「ロリポップ！のドメイン」が「 〇〇.capoo.jp 」の場合、「ポータルのURL」には「 |
| https接続を強制する | チェックを入れます。 |
| 実行委員会の名称 | 学園祭実行委員会の名称を入力します。ここで入力された名前は、PortalDotsから送信されるメールの文面など、PortalDotsの画面上に表示されます。 |
| 実行委員会のメールアドレス | 学園祭参加企画からのお問い合わせを受け付けるメールアドレスを入力します。PortalDotsから送信された「お問い合わせ」はこのメールアドレスに届くほか、PortalDotsから送信されるメールの文面など、PortalDotsの画面上に表示されます。 |
| 学校発行メールアドレスのローカルパート種別 | 学校が学生に配布・発行しているメールアドレスについて、「@(アットマーク)」より前の文字列が下記のどちらに該当するかを選択してください。
- 学籍番号
- 学籍番号ではない文字列 (学籍番号に関係のない文字が1文字以上含まれている場合もこちらを選択)
|
| 学校発行メールアドレスのドメイン | 学校が学生に配布・発行しているメールアドレスの「@」より後の文字列を入力します。 |
上記以外の設定項目については、各学校・各学園祭の事情にあった情報を入力してください。
## 5.2.「MySQL データベース設定」
「MySQL データベース設定」では、「[2. データベースを作成する](/4.x/setup/install/lolipop/database)」でメモした情報を入力します。
| 設定項目 | 説明 |
| ----------- | ------------------------ |
| データベースのホスト名 | メモした「サーバー」を入力します。 |
| ポート番号 | 半角数字で「3306」を入力します。 |
| データベース名 | メモした「データベース名」を入力します。 |
| ユーザー名 | メモした「データベースユーザー名」を入力します。 |
| パスワード | メモした「データベースパスワード」を入力します。 |
## 5.3. 「メール配信設定」
「メール配信設定」では、「[3. メールサーバーを確認する](/4.x/setup/install/lolipop/email)」でメモした情報を入力します。入力後「保存して次へ」をクリックすると、「実行委員会のメールアドレス」に対してテストメールが送信されます。
| 設定項目 | 説明 |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| メールサーバー(SMTP)のホスト | メモした「SMTP メールサーバー」の先頭に「ssl://」をつけたものを入力します。
「SMTP メールサーバー」が「smtp.lolipop.jp」の場合、「ssl://smtp.lolipop.jp」を入力してください。
|
| メールサーバー(SMTP)のポート | メモしたポート番号(半角数字)を入力します。 |
| メールユーザー名 | メモした「メールアカウント」を入力します。 |
| メールパスワード | メモした「メールパスワード」を入力します。 |
| PortalDotsから配信されるメールの差出人メールアドレス | メモした「メールアドレス」を入力します。 |
| PortalDotsから配信されるメールの差出人の名前 | 任意の文字列を設定できます。ウェブシステムの名前や実行委員会の名前にするのがお勧めです。ここで設定した名前は、PortalDotsから送信されるメールをユーザーが確認する際、メールアプリの「差出人」欄に表示されます。 |
## 5.4. 「管理者ユーザーの設定」
1. 「管理者ユーザーの作成」では、あなた自身の情報を入力してください。
2. 「登録してインストール実行」をクリックすると、データベース上に PortalDots関連データの保存領域が作成され、管理者ユーザー情報がデータベース上に保存されます。
3. 「メール確認」ページが表示されます。「学校発行メールアドレス」と「連絡先メールアドレス」それぞれに1通ずつ確認メールが送信されます。それぞれのメールに記載されたURLにアクセスしてください。2通のURLにアクセスしたら、インストール完了です！
続いて、PortalDotsからメール配信を行うための設定を行います。
# ステップ6. メールの一斉配信機能のセットアップ(CRONの設定)
「お知らせ」をユーザー全員に一斉配信するためには、CRONの設定が必要です。
1. CyberduckでサーバーにFTP接続します
2. Cyberduckの画面上の cron フォルダをダブルクリックして開きます
3. `lolipop.sh.sample` というファイルを右クリックし、「名前の変更」をクリックします
4. 名前を入力できるようになったら、「`lolipop.sh.sample`」を「`lolipop.sh`」に変更し、Enterキーを押します
5. 「名前したファイルを移動しますか？」と表示されたら「名前を変更」をクリックします
6. 「`lolipop.sh`」を右クリックし、「エディタで編集」を選択し、表示されるプログラム名(メモ帳など)をクリックします。
7. ファイル内の「PortalDotsのフォルダ」と書かれている箇所を削除し、代わりに ホームディレクトリのパスを入力してください。入力できたらファイルを保存してください。自動的にサーバーへアップロードされます。
* ホームディレクトリのパスは、「ロリポップ！ユーザー専用ページ」内で確認できます。画面左のメニューから「ユーザー設定」を選び、「アカウント情報」をクリックした後に表示される「フルパス」が、ホームディレクトリのパスです。
8. `lolipop.sh` を右クリックし、「情報」をクリックします
9. 「アクセス権」タブを開き、「オーナー」という行にある「実行」にチェックを入れます。\
10. 「ロリポップ！ユーザー専用ページ」にログインします
11. 画面左のメニューから「サーバーの管理・設定」を選び、「cron設定」をクリックします
12. 以下のように入力します。
* 「cronの設定名」には「PortalDots」と入力します。
* 「日付（月）」では「毎月」を選択します。
* 「日付（日）」では「毎日」を選択します。
* 「曜日」では「毎日」を選択します。
* 「時間（時）」では「毎時」を選択します。
* 「時間（分）」では「10分毎」を選択します。
13. 「スケジュール」欄に「10分毎 のスケジュールで実行します」と表示されたことを確認します。
14. 「実行ファイルパス」には「cron/lolipop.sh」と入力します。
15. 「設定」ボタンをクリックします。
16. 以上でCRON設定は完了です。「お知らせ」の一斉配信機能が利用可能になります。
以上でPortalDotsのインストールは完了です！お疲れ様でした！
# こんなときはどうする？
ロリポップ！レンタルサーバー上でPortalDotsをセットアップしている間にトラブルが発生した場合、以下をご確認ください。
## インストール中にエラーが発生したとき
* **PortalDots 1 はロリポップ！レンタルサーバーで動作しません。PortalDots 3 以上をご利用ください。**
* 「MySQL データベース設定」や「メール配信設定」をしようとしてもエラーになる場合、入力したパスワードなどが間違っていないかご確認ください。
* 「データベースパスワード」と「メールパスワード」は、通常異なるパスワードです。「データベースパスワード」を入力するべきところ「メールパスワード」を入力してしまっているなど、パスワードの入力に誤りがないかご確認ください。
* 「メール配信設定」にある「メールサーバー(SMTP)のホスト」の入力欄では、先頭に「ssl://」をつける必要があります。
* 「メール配信設定」にある「メールサーバー(SMTP)のホスト」の入力欄に入力したものが「SMTP メールサーバー」となっているかご確認ください。
* ロリポップ！レンタルサーバーでは、「SMTP メールサーバー」の他に「POP メールサーバー」や「IMAP メールサーバー」があります。このうち、「POP メールサーバー」や「IMAP メールサーバー」の情報は PortalDots のインストールに不要なものです。
## それでも解決しないとき
[PortalDots の LINE 公式アカウント](https://lin.ee/aeee9s9)では、PortalDots のセットアップ方法や利用方法に関する質問を受け付けております(無料)。ぜひご活用ください。
{% hint style="warning" %}
PortalDots開発チームはボランティアによる活動です。LINEでのサポートは解決を保証するものではありません。予めご了承ください。
{% endhint %}
# コアサーバーに PortalDotsをインストールする
コアサーバーに PortalDotsをインストールする方法をご説明します。
{% hint style="info" %}
ここでは、PortalDots 3 以上について説明しています。PortalDots 1 はさくらのレンタルサーバーでのみ動作します。
{% endhint %}
## 「コアサーバー」で PortalDots を利用するメリット・デメリット
* 「コアサーバー」は比較的高機能なレンタルサーバーです。メールサポートはありますが、ある程度のサーバー運用の知識が必要になります。サーバー運用に自信がない場合は、他のレンタルサーバーの利用をご検討ください。
* 「コアサーバー」では、利用料金の支払いにクレジットカード決済のほか、銀行振替やコンビニ決済が利用できます。
* 「コアサーバー」の利用には、「バリュードメイン」のユーザーアカウントを作成する必要があります。また「コアサーバー」の利用料金の支払いは、「バリュードメイン」の画面上で行います。
* 「お知らせ」の検索機能はコアサーバーでは利用できません。検索機能を利用したい場合、MySQL 5.7 以上に対応した他のレンタルサーバーの利用をご検討ください。
## このマニュアルで説明する内容
* FTP 接続ソフトとして Cyberduck を使用する前提で説明します。
* レンタルサーバー申し込み時に決める URL を、PortalDots の URL としてそのまま利用する前提で説明します。
* 独自ドメインを利用したい場合のセットアップ方法は、このページでは説明しません。
* PortalDots から自動配信するメールの差出人のメールアドレスをカスタマイズしたい場合のセットアップ方法は、このページでは説明しません。
では早速、以下の「ステップ1」をクリックし、PortalDots のインストール方法を見ていきましょう。
# ステップ1. コアサーバーに申し込む（無料お試しあり）
まずはPortalDotsをインストールするレンタルサーバーを申し込みましょう。
※無料お試しは、お支払い方法の入力は不要です。
1. コアサーバーの「[お申込みとその流れ](https://www.coreserver.jp/signup/)」ページに掲載されている申し込み方法に従って、コアサーバーに申し込みます。
* CORE-X(ライトプラン)、CORE-Y(スタンダードプラン)、CORE-Z(ビジネスプラン)いずれでもPortalDotsは動作します。特に希望がない場合は、一番安価なCORE-X(ライトプラン)をお勧めします。
* 支払い方法に関しても「お申込みとその流れ」ページに掲載されていますのでご確認ください。
2. コアサーバーへの申し込みが完了したら、次の「2. データベースを作成する」へ進みます
* コアサーバーのコントロールパネルにログインするための「アカウント名」「パスワード」「サーバー」は、申込み時に届くメール（件名 : CORESERVER.JP NEW SIGNUP）に掲載されています。
{% hint style="warning" %}
パスワードの使い回しや複数人での共有は危険です。\
PortalDots上ではユーザーの個人情報を多く扱うことになります。コアサーバーのパスワードが漏洩すると、ユーザーの個人情報が流出する恐れがありますので、パスワードの取り扱いには十分ご注意ください。
{% endhint %}
# ステップ2. データベースを作成する
PortalDots上に保存するデータ（ユーザー情報や参加企画情報など）は、データベース上に保存されます。PortalDotsのインストール前に、あらかじめデータベースを作成しておきます。
1. コアサーバーのコントロールパネルにログインします
* 申込み時に届くメールに掲載されている「アカウント名」「パスワード」「サーバー」でログインできます。
2. 画面左のメニューから「データベース」をクリックします
3. 「新しいデータベースを作成」ボタンをクリックします
4. 「データベース名」と「データベースパスワード」は任意のものを設定します。「データベース名」と「データベースユーザ」は同じもので構いません。ここで入力した「**データベース名**」と「**データベースユーザ**」、「**データベースパスワード**」は、PortalDots をインストールする際に必要です。
5. 「データベースを作成」ボタンをクリックします。
6. 「DATABASE CREATED」という画面が表示されます。この画面内に表示されている「**Database**」、「**Host**」、「**Username**」、「**Password**」を確認、メモしてください。これらの情報は、PortalDots をインストールする際に必要です。
{% hint style="warning" %}
「データベースパスワード」は、他の用途で利用していないパスワードを設定してください。このパスワードが漏洩すると、PortalDotsに保存されたユーザー情報が全て漏洩します。必ずランダムな文字列をパスワードとして設定してください。
{% endhint %}
# ステップ3. メールアカウントを作成する
PortalDots では、ユーザーへメールを自動送信するために、コアサーバーのメールサーバー情報が必要になります。PortalDots からのメルマガの配信を予定していない場合でも、メールサーバーの設定は必須です。
1. コアサーバーのコントロールパネルにログインします
2. 画面左のメニューから「メール」をクリックします
3. 「アカウントを作成」をクリックします
4. 「ユーザー名」の入力欄では、PortalDots から送信されるメールの差出人の、「@」より前の文字列を設定できます。「パスワード」は任意のものを設定します。「Eメールのクォータ」はデフォルト値で構いません。「送信数を制限」では、「無制限」にチェックを入れます。
* 特に希望がない場合、「ユーザー名」は「portal」がお勧めです。
5. 「アカウントを作成」をクリックします。
6. 「ACCOUNT CREATED」という画面が表示されます。この画面内に表示されている「**Username**」、「**Password**」、「**SMTP Server**」、「**port**」を確認、メモしてください。これらの情報は、PortalDots をインストールする際に必要です。\\
{% hint style="warning" %}
「パスワード」は、他の用途で利用していないパスワードを設定してください。このパスワードが漏洩すると、第三者が PortalDots のシステムになりすましてメールを送信することが可能になります。必ずランダムな文字列をパスワードとして設定してください。
{% endhint %}
# ステップ4. 通信を暗号化するためにSSLを設定する(無料)
PortalDots では参加企画のメンバーの個人情報などを扱うことになります。通信が傍受されると情報漏洩のリスクがあるため、SSL証明書を設定します。ここでは、無料のSSL証明書(Let's Encrypt)を利用します。
PortalDots では参加企画のメンバーの個人情報などを扱うことになります。通信が傍受されると情報漏洩のリスクがあるため、SSL証明書を設定します。ここでは、無料のSSL証明書(Let's Encrypt)を利用します。
1. コアサーバーのコントロールパネルにログインします
2. に記載されている方法に従い、SSLを有効化してください。
# ステップ5. PortalDotsをサーバーにアップロードする
データベースとメールサーバーの確認ができたら、いよいよPortalDotsをサーバーへアップロードします。
{% hint style="info" %}
ブラウザ上で利用できる「ファイルマネージャー」では PortalDotsをアップロードできません
{% endhint %}
1. コアサーバー申込み時に届くメール（件名 : CORESERVER.JP NEW SIGNUP）に記載されている「**アカウント名(FTPユーザー名)**」「**パスワード**」「**ＦＴＰサーバー**」を確認、メモします。
2. FTPソフトでFTP接続します。FTPソフトをインストールしていない場合、Cyberduckがお勧めです。設定方法はロリポップ！レンタルサーバーのサポートページに掲載されています([Macの場合](https://lolipop.jp/manual/hp/m-cyberduck/) / [Windowsの場合](https://lolipop.jp/manual/hp/w-cyberduck/))。
* Cyberduckの場合、「環境設定」内の「ブラウザ」タブにある「'.'で始まるファイルを表示」にチェックを入れてください\
3. Cyberduckの画面上の「public\_html」フォルダをダブルクリックして開きます。
4. 初期状態ではいくつかのファイルが設置されています。これらは不要なため、ファイル上で右クリックして削除します。
5. [PortalDots.zip](https://github.com/portaldots/PortalDots/releases/latest/download/PortalDots.zip) をダウンロードし、展開します。
6. 展開してできたフォルダの中身を全て「public\_html」フォルダ内へアップロードします。Cyberduckの場合、Finder(macOSの場合)またはエクスプローラー(Windowsの場合)からファイルをドラッグ&ドロップしてください。
* 隠しファイル(ドットで始まるファイル)も含めてアップロードしてください。macOS や Linux などの OS では、デフォルトではこれらのファイルは非表示になっています。macOS の場合、Finder で Command + Shift + . を押すと隠しファイルが表示されます。\
7. アップロードには5分〜10分程度時間がかかりますので、お待ちください。
8. アップロードが完了したら、コアサーバーのコントロールパネルにログインします。
9. 画面左のメニューから「ドメイン」をクリックします。
10. ドメイン一覧の表に記載されている「〇〇.△△.coreserver.jp」という形式のURLを確認、メモします。
11. 先ほど確認したURLの先頭に「https\://」をつけたURLにアクセスしてください。
* 先ほど確認したURLが「〇〇.△△.coreserver.jp」の場合、「 」にアクセスしてください。
12. 「PortalDotsへようこそ！」という画面が表示されたら、アップロード完了です。
# ステップ6. PortalDotsのインストール作業を進める
ウェブシステムの名前や、ここまでで確認してきたデータベースやメールサーバーの設定を行います。
「PortalDotsへようこそ！」画面にある「設定をはじめる」をクリックします。
## 5.1. 「ポータルの情報」設定
「ポータルの情報」画面では、以下のように設定します。
| 設定項目 | 説明 |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ポータルの名前 | ウェブシステムの名前を設定します。例えば「門点祭ウェブシステム」など、「〇〇祭ウェブシステム」という名前がお勧めです。 |
| ポータルのURL | 「[5. PortalDots をサーバーにアップロードする](/4.x/setup/install/coreserver/upload)」で確認したURLの先頭に、「https\://」を追加したものを入力してください。確認したURLが「〇〇.△△.coreserver.jp」の場合、「ポータルのURL」には「 」と入力してください。 |
| https接続を強制する | チェックを入れます。 |
| 実行委員会の名称 | 学園祭実行委員会の名称を入力します。ここで入力された名前は、PortalDotsから送信されるメールの文面など、PortalDotsの画面上に表示されます。 |
| 実行委員会のメールアドレス | 学園祭参加企画からのお問い合わせを受け付けるメールアドレスを入力します。PortalDotsから送信された「お問い合わせ」はこのメールアドレスに届くほか、PortalDotsから送信されるメールの文面など、PortalDotsの画面上に表示されます。 |
| 学校発行メールアドレスのローカルパート種別 | 学校が学生に配布・発行しているメールアドレスについて、「@(アットマーク)」より前の文字列が下記のどちらに該当するかを選択してください。
- 学籍番号
- 学籍番号ではない文字列 (学籍番号に関係のない文字が1文字以上含まれている場合もこちらを選択)
|
| 学校発行メールアドレスのドメイン | 学校が学生に配布・発行しているメールアドレスの「@」より後の文字列を入力します。 |
上記以外の設定項目については、各学校・各学園祭の事情にあった情報を入力してください。
## 5.2.「MySQL データベース設定」
「MySQL データベース設定」では、「[2. データベースを作成する](/4.x/setup/install/coreserver/database)」でメモした情報を入力します。
| 設定項目 | 説明 |
| ----------- | --------------------- |
| データベースのホスト名 | メモした「Host」を入力します。 |
| ポート番号 | 半角数字で「3306」を入力します。 |
| データベース名 | メモした「Database」を入力します。 |
| ユーザー名 | メモした「Username」を入力します。 |
| パスワード | メモした「Password」を入力します。 |
## 5.3. 「メール配信設定」
「メール配信設定」では、「[3. メールアカウントを作成する](/4.x/setup/install/coreserver/email)」でメモした情報を入力します。入力後「保存して次へ」をクリックすると、「実行委員会のメールアドレス」に対してテストメールが送信されます。
| 設定項目 | 説明 |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| メールサーバー(SMTP)のホスト | メモした「SMTP Server」を入力します。 |
| メールサーバー(SMTP)のポート | メモした「port」(半角数字)を入力します。 |
| メールユーザー名 | メモした「Username」を入力します。 |
| メールパスワード | メモした「Password」を入力します。 |
| PortalDotsから配信されるメールの差出人メールアドレス | メモした「Username」を入力します。 |
| PortalDotsから配信されるメールの差出人の名前 | 任意の文字列を設定できます。ウェブシステムの名前や実行委員会の名前にするのがお勧めです。ここで設定した名前は、PortalDotsから送信されるメールをユーザーが確認する際、メールアプリの「差出人」欄に表示されます。 |
## 5.4. 「管理者ユーザーの設定」
1. 「管理者ユーザーの作成」では、あなた自身の情報を入力してください。
2. 「登録してインストール実行」をクリックすると、データベース上に PortalDots関連データの保存領域が作成され、管理者ユーザー情報がデータベース上に保存されます。
3. 「メール確認」ページが表示されます。「学校発行メールアドレス」と「連絡先メールアドレス」それぞれに1通ずつ確認メールが送信されます。それぞれのメールに記載されたURLにアクセスしてください。2通のURLにアクセスしたら、インストール完了です！
続いて、PortalDotsからメール配信を行うための設定を行います。
# ステップ7. メールの一斉配信機能のセットアップ(CRONの設定)
「お知らせ」をユーザー全員に一斉配信するためには、CRONの設定が必要です。
1. コアサーバーのコントロールパネルにログインします
2. 画面左のメニューから「ツール」をクリックします
3. 画面左側のメニューから「CRONジョブ」をクリックします
4. 「CRONジョブを作成」ボタンをクリックします
5. 「分」に「\*/10」と入力、「時間」「日」「月」「曜日」には「\*」と入力してください
6. 「コマンド」には `/usr/local/bin/php /home/〇〇/public_html/artisan schedule:run` と入力してください
* 〇〇の部分には、コアサーバーのコントロールパネルの画面右上に表示されている「アカウント」を入れてください。（以下の画像の〇〇の部分です）\
7. 「作成」ボタンをクリックします
8. 以上でCRON設定は完了です。「お知らせ」の一斉配信機能が利用可能になります。
以上でPortalDotsのインストールは完了です！お疲れ様でした！
# こんなときはどうする？
コアサーバー上でPortalDotsをセットアップしている間にトラブルが発生した場合、以下をご確認ください。
## インストール中にエラーが発生したとき
* **PortalDots 1 はコアサーバーで動作しません。PortalDots 3 以上をご利用ください。**
* 「MySQL データベース設定」や「メール配信設定」をしようとしてもエラーになる場合、入力したパスワードなどが間違っていないかご確認ください。
* 「データベースパスワード」と「メールパスワード」は、通常異なるパスワードです。「データベースパスワード」を入力するべきところ「メールパスワード」を入力してしまっているなど、パスワードの入力に誤りがないかご確認ください。
* 「ポータルの情報」設定で設定した「実行委員会のメールアドレス」によっては、「メール配信設定」時にエラーとなることがあります。その場合は、一度「ポータルの情報」設定に戻り、違う「実行委員会のメールアドレス」を設定してみてください。
## 「ポータルの情報」を設定後、PortalDots にアクセスできなくなったとき
SSL の設定をしていない状態で、「ポータルの情報」設定の「https 接続を強制する」にチェックを入れると、PortalDots にアクセスできなくなります。
* SSL の設定をしたにも関わらず PortalDots にアクセスできなくなった場合、サーバー側の SSL 設定の処理が完了していない可能性があります。しばらく待ってから再度 PortalDots にアクセスしてください。
* SSL の設定をしていない場合、「[4. 通信を暗号化するために SSL を設定する(無料)](/4.x/setup/install/coreserver/ssl)」に従って SSL の設定をした後、しばらく待ってから再度 PortalDots にアクセスしてください。
## それでも解決しないとき
[PortalDots の LINE 公式アカウント](https://lin.ee/aeee9s9)では、PortalDots のセットアップ方法や利用方法に関する質問を受け付けております(無料)。ぜひご活用ください。
{% hint style="warning" %}
PortalDots開発チームはボランティアによる活動です。LINEでのサポートは解決を保証するものではありません。予めご了承ください。
{% endhint %}
# PortalDotsのユーザー登録をしてもらう
PortalDotsの機能を最大限活用するには、学園祭参加企画の担当者と学園祭実行委員会のメンバー全員がPortalDotsにユーザー登録することが重要になってきます
## 概要
PortalDotsで構築したウェブシステム上で学園祭参加企画が参加登録を提出したり、実行委員がお知らせや申請フォームを作成したりするためには、PortalDotsで構築したウェブシステムに「**ユーザー登録**」する必要があります。
また、実行委員がPortalDotsの「スタッフモード」を利用するには、実行委員に「ユーザー登録」をしてもらった後、ウェブシステムの管理者が実行委員ユーザーを **「スタッフ」として登録する必要があります**。
本記事では、「ユーザー登録」をしてもらう必要がある方についてご説明します。また、「ユーザー登録」の方法についてご説明します。
## 「ユーザー登録」をする必要のある方
* **学園祭参加企画のメンバー**のうち、以下の方（PortalDots上で「企画参加登録」を提出するために「ユーザー登録」が必要）
* 参加企画の責任者
* 参加企画の副責任者（主に実行委員会とのコミュニケーションを担当される方。学園祭によっては「学園祭係」などと呼ばれることもあります）
* **学園祭実行委員会のメンバー**
* 全員が登録されることが望ましいですが、「お知らせ」や「配布資料」、「申請フォーム」の作成・管理される方だけが「ユーザー登録」を実施しても構いません
## 「ユーザー登録」の方法
1. PortalDotsで構築したウェブシステムにアクセスします。
2. ウェブシステムホーム画面にある「はじめての方は新規ユーザー登録」を選びます。
3. 学籍番号、名前、連絡先メールアドレス、連絡先電話番号、ウェブシステムにログインするためのパスワードを入力します。PortalDotsの設定によっては学校発行メールアドレスの入力が追加で必要な場合があります。
4. 学校発行メールアドレスと連絡先メールアドレスの両方に対して送信された確認メールを開き、メール文面内の URL にアクセスします。
5. `4.` で両方の URL にアクセスができ次第、「ユーザー登録」完了となります。
{% hint style="warning" %}
学園祭実行委員会のメンバーがPortalDotsの「スタッフモード」を利用できるようにするには、そのユーザーを「スタッフ」として登録する必要があります。詳細については『[実行委員ユーザーが「スタッフモード」にアクセスできるようにする](/4.x/setup/create-staff-user)』をご覧ください。
{% endhint %}
# 実行委員ユーザーが「スタッフモード」にアクセスできるようにする
実行委員がPortalDotsスタッフモードを利用できるようにする方法についてご説明します
## 概要
「ユーザー登録」のみを実施したユーザーは、PortalDots上では「一般ユーザー」として扱われます。PortalDotsの機能のうち、ユーザー情報や参加企画情報の閲覧・編集、「お知らせ」や「配布資料」、「申請フォーム」の作成・管理などの機能を利用したい場合、ユーザーを「スタッフ」として登録する必要があります。
{% hint style="info" %}
PortalDotsにユーザー登録する方法については「[PortalDotsのユーザー登録をしてもらう](/4.x/setup/user-registration)」をご覧ください。
{% endhint %}
## ユーザーを「スタッフ」として登録する
1. スタッフとしたいユーザーに、予め PortalDots にユーザー登録をしてもらいます。
2. 既にスタッフまたは管理者ユーザーとして登録しているアカウントで PortalDots にログインします。
3. 「スタッフモード」を開きます。
4. メニューから「ユーザー情報管理」を選びます。
5. スタッフとして追加したいユーザーを探し、当該ユーザーの(編集)ボタンを選びます。
6. 「ユーザー種別」を「スタッフ」に変更し、「保存」を選びます。
これで、当該ユーザーは「スタッフモード」にアクセスできるようになります。
{% hint style="info" %}
以上の手順とは別に、「スタッフ」ユーザーに対して「スタッフの権限設定」を実施しないと、そのユーザーはスタッフモードの機能を一切利用できません。
{% endhint %}
## 「スタッフの権限設定」で「スタッフ」ユーザーが「スタッフモード」内の機能を利用できるようにする
「ユーザー種別」が「スタッフ」のユーザーは、「管理者」ユーザーに「スタッフの権限設定」を行ってもらうまで、スタッフモードの各種機能は利用できません。管理者ユーザーは、以下に記載の方法で、スタッフユーザーが各種機能を利用できるように設定してください。
1. 既に管理者ユーザーとして登録しているアカウントで PortalDots にログインします。
2. 「スタッフモード」を開きます。
3. メニューから「スタッフの権限設定」を選びます。
4. 「スタッフモード」の機能を利用できるように設定したいユーザーを探し、当該ユーザーの✏️(編集)ボタンを選びます。
5. そのユーザーが利用できるようにする機能にチェックを入れ、「保存」を選びます。
{% hint style="warning" %}
セキュリティのため、各ユーザーが利用できる機能は最小限にしてください。例えば、企画情報の確認ができれば十分なユーザーには、企画の編集ができない「スタッフモード › 企画情報管理 › 閲覧」という権限を付与してください。
{% endhint %}
# 「一般モード」と「スタッフモード」
PortalDotsには「一般モード」と「スタッフモード」という2種類のモードがあります。「一般モード」は、学園祭の参加企画が利用するモードです。「スタッフモード」は、学園祭の実行委員(スタッフ)のみが利用できるモードです。
## それぞれのモードについて
PortalDotsには2種類のモードがあります。それぞれ利用可能なユーザーが異なります。
### 一般モード
学園祭の参加企画のメンバー(一般ユーザー)が利用するモードです。主に下記の機能が利用できます。
* 企画参加登録の提出
* お知らせ・配布資料の閲覧
* 申請フォームへの回答
* 学園祭実行委員会へのお問い合わせ、など
「一般モード」で利用できる機能の詳細については、「[PortalDotsでできること(一般モード)](/4.x/circles/list)」をご覧ください。
## スタッフモード
学園祭の実行委員(スタッフ)のみが利用できるモードです。主に下記の機能が利用できます。
* PortalDotsに登録されているユーザー情報の管理
* 企画・場所情報の管理
* 一般ユーザー向けに掲載するお知らせ・配布資料の作成、など
「スタッフモード」で利用できる機能については、「[PortalDotsでできること(スタッフモード)](/4.x/features/list)」をご覧ください。
# PortalDotsでできること(スタッフモード)
PortalDotsの基本機能をご紹介します。
PortalDotsには、学園祭実行委員会が学園祭を作り上げるために必要な機能が多数揃っています。ここでは、学園祭実行委員(スタッフ)が利用できるPortalDotsの基本機能の概要と使い方をご紹介します。
ここでご紹介している機能は一部です。今後も随時、機能紹介を追加していきます。
{% content-ref url="/pages/FMqa4dwgTCQEpxs3yTuf" %}
[PortalDotsを使って企画参加登録を受け付ける](/4.x/features/circle-registration)
{% endcontent-ref %}
{% content-ref url="/pages/93OSDODJ3oQ92ZFmUMpq" %}
[学園祭参加企画向けのお知らせを掲載・メール配信する](/4.x/features/pages)
{% endcontent-ref %}
{% content-ref url="/pages/pjbC3FcmCfmg8gPinNGH" %}
[学園祭参加企画にPDFなどのファイルを配布する](/4.x/features/documents)
{% endcontent-ref %}
{% content-ref url="/pages/bWIy1GOIyJmZ99urZaTG" %}
[学園祭当日に使用できる場所の一覧や各企画への場所の割り当てを管理する](/4.x/features/places)
{% endcontent-ref %}
{% content-ref url="/pages/8O1b0iT2m8fBqCSOTqYm" %}
[学園祭参加企画からの各種申請をオンラインで受け付ける](/4.x/features/forms)
{% endcontent-ref %}
{% content-ref url="/pages/CaTnwVfRPm1Jb7zuHEIw" %}
[学園祭参加企画からのお問い合わせを受け付ける](/4.x/features/contact-form)
{% endcontent-ref %}
{% hint style="info" %}
PortalDotsの機能のうち、学園祭の参加企画が利用可能な機能については「[PortalDotsでできること(一般モード)](/4.x/circles/list)」をご覧ください。
{% endhint %}
# PortalDotsを使って企画参加登録を受け付ける
PortalDotsを使えば、学園祭への企画参加登録をオンライン上で受け付けることができます。
## 概要
PortalDotsの「企画参加登録」機能を有効にすると、学園祭への企画参加登録をオンライン上で受け付けることができます。企画情報の入力から、責任者の登録、企画参加登録の提出までオンライン上で完結するため、企画参加登録を受け付ける手間が大幅に省けます。
受け付けた企画参加登録の一覧は、「スタッフモード」内の「企画情報管理」で確認でき、CSV形式で企画一覧をダウンロードすることもできます。「カスタムフォーム」機能を利用することで、企画参加登録フォームに独自の入力欄(設問)を追加することもできます。
## 「企画参加登録」機能の事前設定
### 「企画参加登録」機能を有効にする
「企画参加登録」機能を利用するには、まず「企画参加登録機能を有効にする」必要があります。
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 「企画参加登録機能の設定」を選びます。
4. 「企画参加登録機能を有効にする」というボタンを選びます。「企画参加登録機能を有効にする」が表示されていない場合、「企画参加登録」機能は既に利用可能な状態になっています。
{% hint style="warning" %}
「企画参加登録」機能を有効にしただけでは、企画参加登録の受付は開始されません。企画参加登録の受付を開始するには、「企画参加登録の設定」を行う必要があります。
{% endhint %}
### 「企画参加登録」の受付を開始する（企画参加登録の設定）
「企画参加登録」機能を有効にすると、「企画参加登録」機能の設定を変更することができるようになります。
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 以下の表に記載されている設定項目を変更できる画面が表示されます。設定を確認・変更し、「保存」を選びます。
| 設定項目 | 説明 |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 企画参加登録のカスタムフォーム | 「企画参加登録」フォームでは、予め「企画名」と「団体名」の入力欄が表示されるようになっています。「カスタムフォーム」機能を使うことで、「企画名」と「団体名」以外の独自の入力欄(設問)を追加できます。
設問の追加・編集方法については、「フォームエディターで申請フォームを作成する」をご覧ください。
|
| 企画参加登録を提出するために必要な企画担当者の最低人数 | 「企画参加登録」を提出する際に登録が必要な企画責任者と学園祭係(副責任者)の合計人数を設定できます。企画責任者に加え、学園祭係(副責任者)の登録を最低2人必要とする場合、3と入力してください。 |
| 受付開始日時 | 「企画参加登録」を受付開始する日時を入力します。この日時以前、企画参加登録画面はユーザーには非表示となります。 |
| 受付終了日時 | 「企画参加登録」を受付開始する日時を入力します。この日時以降、企画参加登録画面はユーザーには非表示となります。 |
| 参加登録画面の公開設定 | 「企画参加登録」フォームを公開するには「公開する」にチェックを入れます。「公開する」にチェックが入っていても、受付開始日時以前・受付終了日時以降、「企画参加登録」フォームは公開されません。 |
| 参加登録前に表示する内容 | 「企画参加登録」フォームの冒頭に文章を表示することができます。「企画参加登録」にあたっての注意点や、企画参加規約などを表示する際にご活用ください。 |
## 「企画参加登録」の流れ
参加企画側が「企画参加登録」を提出しただけでは**企画参加登録は完了しません**。スタッフ側で提出された「企画参加登録」を確認し、企画を「受理」することで「企画参加登録」が完了します。
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 「登録受理状況」が「**確認中**」となっている企画の✏️(編集)ボタンを選びます。
4. 入力されている企画情報を確認し、「企画参加登録」を受理する場合は「参加登録の受理設定」にある「**受理**」にチェックを入れます。
5. 「保存」を選びます。
{% hint style="info" %}
「登録受理状況」を「受理」または「不受理」にチェックを入れると、その企画のメンバーに対し、企画が受理された(されなかった)旨が記載されたメールが送信されます。
{% endhint %}
{% hint style="info" %}
企画編集画面に表示されるその他の入力項目についての詳細は、「[学園祭参加企画を手動でPortalDotsに登録・編集する](/4.x/advanced/manual-circle-registration#no)」をご覧ください。
{% endhint %}
# 学園祭参加企画向けのお知らせを掲載・メール配信する
PortalDotsを使えば、学園祭に参加する企画向けのお知らせをオンライン上で掲載したり、メール配信したりすることができます。
## 概要
PortalDotsの「お知らせ」機能を利用することで、PortalDotsで構築した学園祭ウェブシステム上で「お知らせ」を掲載することができます。また、CRONが適切に設定されている場合、PortalDotsに登録されている全ユーザーに対して「お知らせ」をメール配信できます。
「企画情報管理」の「企画タグ」機能と併用することで、「お知らせ」を閲覧できるユーザーや、「お知らせ」のメール配信を受け取るユーザーを制限することもできます。
{% hint style="info" %}
CRONの設定方法はサーバーによって異なります。詳細は[セットアップ方法](/4.x/setup/install)をご覧ください。
{% endhint %}
## 「お知らせ」を作成する
1. 「スタッフモード」を開きます。
2. メニューから「お知らせ管理」を選びます。
3. 「新規お知らせ」を選びます。
4. 以下の表に記載されている入力欄が表示されます。入力欄に入力し終わったら「保存」を選びます。
| 入力項目 | 説明 |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| タイトル | 作成する「お知らせ」のタイトルを入力します。「お知らせ」をメール配信する場合は、このタイトルがメールの件名になります。 |
| 本文 | 作成する「お知らせ」の本文を入力します。 |
| 関連する配布資料 | 作成する「お知らせ」に添付したい配布資料を選択します。「配布資料」機能で予め作成した配布資料から選択できます。
PortalDotsの「配布資料」機能の詳細はこちらをご覧ください
|
| お知らせを閲覧可能なユーザー | （後述） |
| 公開設定 | 「公開」にチェックを入れるとお知らせが公開されます。「非公開」にチェックを入れるとお知らせは公開されません。 |
| お知らせを固定表示 | （後述） |
| 保存後にこのお知らせを「閲覧可能なユーザー」で指定したユーザー全員にメール配信 | 「お知らせ」を保存したタイミングで「お知らせ」のメール配信を行いたい場合、チェックを入れてください。 |
| スタッフ用メモ | 一般ユーザーには公開されないスタッフ用のメモを入力できます。 |
### 「お知らせを閲覧可能なユーザー」について
PortalDotsに登録されているユーザー全員に対して公開する必要がなく、一部のユーザーにだけ公開したい「お知らせ」がある場合、「お知らせを閲覧可能なユーザー」機能を使って「お知らせ」を閲覧できるユーザーを制限できます。
例えば、「講義棟教室の電源について」という「お知らせ」を、講義棟を利用する企画のメンバーに対してだけ公開したい場合、以下のように設定してください。
1. 予め「企画情報管理」で、講義棟を利用する企画の「企画タグ」入力欄に「**講義棟**」と入力しておく。
2. 「お知らせ」作成画面にある「お知らせを閲覧可能なユーザー」入力欄に「**講義棟**」と入力する。
3. 「お知らせ」を保存する。
### 「お知らせを固定表示」について
「お知らせを固定表示」にチェックを入れると、その「お知らせ」はホームの一番上に全文表示されます（上図）。また、「お知らせ」一覧では非表示になります。
「お知らせを閲覧可能なユーザー」と「お知らせを固定表示」の両方を設定した場合、「お知らせを閲覧可能なユーザー」としてログインしている場合のみ、ホームの一番上に「お知らせ」が全文表示されます。
# 学園祭参加企画にPDFなどのファイルを配布する
PortalDotsを使えば、学園祭に参加する企画向けの各種ファイルを配布することができます。
## 概要
PortalDotsの「配布資料」機能を利用することで、PortalDotsで構築した学園祭ウェブシステム上で「配布資料」を配布することができます。
「配布資料」機能で配布する資料として PDF の他、Word や Excel ファイル、画像ファイルなどをアップロードすることができます。
## 「配布資料」をアップロードする
1. 「スタッフモード」を開きます。
2. メニューから「配布資料管理」を選びます。
3. 「新規配布資料」を選びます。
4. 以下の表に記載されている入力欄が表示されます。入力欄に入力し終わったら「保存」を選びます。
| 入力項目 | 説明 |
| ------------- | ------------------------------------------------------ |
| ファイル | 「配布資料」として配布したいファイルをアップロードします。 |
| 配布資料名 | 「配布資料」のタイトルを入力します。 |
| 説明 | 「配布資料」の説明を入力します。 |
| 公開設定 | 「公開」にチェックを入れると配布資料が公開されます。「非公開」にチェックを入れると配布資料は公開されません。 |
| この配布資料は重要かどうか | 「重要」にチェックを入れると「配布資料」一覧の中で「配布資料」が強調して表示されます。 |
| スタッフ用メモ | 一般ユーザーには公開されないスタッフ用のメモを入力できます。 |
# 学園祭当日に使用できる場所の一覧や各企画への場所の割り当てを管理する
PortalDotsを使えば、学園祭当日に使用できる場所（教室や模擬店ブース）の一覧を管理できます。また、各企画ごとに場所を割り当てることもできます。
## 概要
PortalDotsの「場所情報管理」機能を利用することで、学園祭当日に各企画が利用することのできる場所の一覧を管理することができます。各場所はタイプ（屋内・屋外・特殊場所）別に分類することができます。また、各場所の特徴などをメモとして残しておくこともできます。
PortalDotsの「企画情報管理」機能では、各企画が使用する場所を登録することができます。各場所における企画の割り当て一覧をCSV形式で出力し、Excelで管理することもできます。
## 「場所」を登録する
1. 「スタッフモード」を開きます。
2. メニューから「場所情報管理」を選びます。
3. 「新規場所」を選びます。
4. 以下の表に記載されている入力欄が表示されます。入力欄に入力し終わったら「保存」を選びます。
| 入力項目 | 説明 |
| ------- | --------------------------------------------------------------- |
| 場所名 | 登録する場所の名前を入力します。模擬店の場合はブース名、教室の場合は教室名を入力するのがおすすめです。 |
| タイプ | 場所が「屋外」か「屋内」のどちらにあるのかを選択できます。どちらの分類にも当てはまらない場合は「特殊場所」を選択してください。 |
| スタッフ用メモ | 一般ユーザーには公開されないスタッフ用のメモを入力できます。 |
## 各企画に場所を割り当てる
PortalDotsに登録している企画情報には、それぞれの企画が使用する場所を割り当てることができます。企画に場所を割り当てることで場所の使用状況をPortalDots上で管理できるようになります。
また、各企画に所属しているメンバーがPortalDotsにログインすると、ホーム画面の「企画情報」欄に「使用場所」が表示されるようになります（上図）。これにより、各企画が使用する場所をPortalDots上で簡単に連絡できます。
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 場所を割り当てたい企画の✏️(編集)ボタンを選びます。
4. 「使用場所」欄に、「場所情報管理」で登録した場所の名前を入力します。
5. 「保存」を選びます。
## 各場所に割り当てられている企画の一覧をCSV形式でダウンロードする
PortalDotsに登録した「場所」の情報や、各場所を使用する「企画」の情報をCSV形式でダウンロードすることができます。
1. 「スタッフモード」を開きます。
2. メニューから「場所情報管理」を選びます。
3. 「CSVで出力(場所別企画一覧)」を選びます。
{% hint style="info" %}
「企画情報管理」ページでダウンロードできるCSVファイルにも、各企画の使用場所情報が含まれます。
「企画情報管理」ページでダウンロードできるCSVファイルは「企画ID」順で出力されるのに対し、「場所情報管理」ページでダウンロードできるCSVファイルは「場所ID」順で出力されます。
また、「場所情報管理」ページでダウンロードできるCSVファイルには、各場所ごとに設定した「スタッフ用メモ」の情報も含まれます。
{% endhint %}
# 学園祭参加企画からの各種申請をオンラインで受け付ける
PortalDotsを使えば、学園祭の参加企画から様々な申請を受け付けることができます。場所希望調査、公式パンフレット掲載情報申請、備品貸出申請などをオンラインフォームで受付できます。
## 概要
PortalDotsの「申請管理」機能を利用することで、学園祭参加企画からの各種申請を受け付けることができます。例えば、下記のような申請の受付に利用できます。
* 場所希望調査 (学園祭当日に利用したいブース・教室などの希望を調査)
* 公式パンフレット掲載情報申請 (学園祭の来場者に配布するパンフレットに掲載する企画の紹介文を入稿してもらう)
* 備品貸出申請 (学園祭実行委員会や生協などが保有する備品の貸し出し希望を調査)
* 車両入構申請 (学園祭当日、キャンパス内に入構する車両のナンバー情報などを受付)
{% hint style="warning" %}
申請フォームに回答できるのは、「登録受理状況」が「受理」となっている企画のみです。
企画参加登録の受付方法や「登録受理状況」を変更する方法は、「[PortalDots を使って企画参加登録を受け付ける](/4.x/features/circle-registration)」ページに記載しています。
{% endhint %}
## 「Googleフォーム」等のサービスとの違い
PortalDotsの申請フォームは、「Googleフォーム」等のフォーム作成サービスと同じ感覚で作成できます。しかし、PortalDotsの申請管理機能は、下記の点でGoogleフォーム等のサービスと異なります。
* ログイン機能により、他の企画になりすまして申請フォームに回答できない
* Googleフォームは、フォームへの回答にGoogleアカウントでのログインを必須にすることはできます。しかし、「どの企画の誰か」という情報までは認証できません。
* 申請フォームの回答受付期間を設定できる
* Googleフォームとは異なり、PortalDotsでは申請フォームの受付開始日と終了日を指定できます。
* 一度作成した回答は、申請フォームの受付期間内であれば簡単に編集できる
* Googleフォームの場合、回答を編集するためのURLを紛失すると回答を編集できなくなります。
## 申請フォームを作成する
1. 「スタッフモード」を開きます。
2. メニューから「申請管理」を選びます。
3. 「新規フォーム」を選びます。
4. 以下の表に記載されている入力欄が表示されます。入力欄に入力し終わったら「次に、フォームエディターで設問を作成する」を選びます。
5. フォームエディターが表示されます。申請フォームに表示したい入力欄などを設定してください。ここで設定した内容は即座に公開(公開設定がオンの場合)されます。
| 入力項目 | 説明 |
| -------------- | ---------------------------------------------------------------------------------------- |
| フォーム名 | 申請フォームの名前を入力します。例 : 「公式ウェブサイト掲載情報申請」 |
| 企画毎に回答可能とする回答数 | 通常は「1」にします。 |
| 受付開始日時・受付終了日時 | 申請フォームへの回答を受け付ける期間を入力します。受付期間中、各企画は何度でも回答を編集できます。 |
| 公開設定 | 申請フォームの設問や、過去に行った回答内容を、学園祭の企画担当者が確認できるようにするかを選択します。この設定がオフの場合、回答受付期間中であっても回答を作成・編集できません。 |
| フォームへ回答可能なユーザー | （後述） |
| フォームの説明 | 申請フォームについての説明を入力します。この情報は企画担当者に公開されます。回答時の注意点などを企画担当者に対して説明できます。 |
{% hint style="info" %}
フォームの入力欄(設問)を編集するには「フォームエディター」を利用します。「フォームエディター」の利用方法については、「[フォームエディターで申請フォームを作成する](/4.x/advanced/form-editor)」をご覧ください。
{% endhint %}
### 「フォームへ回答可能なユーザー」について
PortalDotsに登録されているユーザー全員に対してフォームを公開する必要がなく、一部のユーザーにだけ回答してほしいフォームがある場合、「フォームへ回答可能なユーザー」機能を使ってフォームに回答できるユーザーを制限できます。
例えば、「講義棟教室の電源使用申請」というフォームを、講義棟を利用する企画のメンバーに対してだけ公開したい場合、以下のように設定してください。
1. 予め「企画情報管理」で、講義棟を利用する企画の「企画タグ」入力欄に「**講義棟**」と入力しておく。
2. 「フォーム」作成画面にある「フォームへ回答可能なユーザー」入力欄に「**講義棟**」と入力する。
3. フォームを保存する。
## フォームに集まった回答を確認する
各企画から集めたフォームへの回答を確認するには、下記の手順を行います。回答一覧の確認画面では、集まった回答をCSVファイルとしてダウンロードすることもできます。
1. 「スタッフモード」を開きます。
2. メニューから「申請管理」を選びます。
3. 集まった回答を確認したいフォームにある、目のアイコン(回答一覧)ボタンを選びます。
4. フォームに集まった回答の一覧が表示されます。
## 回答が作成・編集されたときに送信されるメールについて
各企画がフォームに対して回答を作成・編集すると、下記のユーザーに回答確認メールが送信されます。
* 回答したユーザーが所属する企画のメンバー全員
* 回答したユーザーがPortalDots上で複数の企画に所属している場合、回答を作成した企画に対してのみメールが送信されます
* フォームを一番最初に作成したスタッフユーザー
{% hint style="info" %}
現時点では、これらのメールの送信を停止することはできません。
{% endhint %}
# 学園祭参加企画からのお問い合わせを受け付ける
学園祭参加企画からのお問い合わせを、PortalDots上のお問い合わせフォームで受け付けることができます。
## 概要
PortalDotsの「お問い合わせ」受付機能を利用することで、学園祭の参加企画からのお問い合わせをウェブフォームで受け付けることができます。
また、お問い合わせの内容に応じて送信先メールアドレスを振り分けることも可能です。
{% hint style="info" %}
お問い合わせフォームからお問い合わせを送信できるのは、PortalDotsにログイン中のユーザーのみです。
{% endhint %}
## 初期状態のお問い合わせフォーム
PortalDotsのお問い合わせフォームは、特段の設定を行うことなくすぐに使うことができます。
PortalDotsをインストール後の初期状態では、ユーザーからのお問い合わせは「実行委員会のメールアドレス」に届きます。「実行委員会のメールアドレス」は、PortalDotsのインストール時に設定したメールアドレスです。
## お問い合わせの内容に応じて送信先のメールアドレスを変える (お問い合わせ受付設定)
「お問い合わせ受付設定」を変更することで、ユーザーからのお問い合わせを内容によって振り分けることができます。例えば、「学園祭の公式ウェブサイトに関するお問い合わせ」と「オンライン開催に関するお問い合わせ」を、それぞれ別のメールアドレスで受信することができます。
お問い合わせ内容を選択させる上記のセレクトボックスをお問い合わせフォームに設置するには、次の手順を行います。
1. 「スタッフモード」を開きます。
2. メニューから「お問い合わせ受付設定」を選びます。
3. 「メールアドレスを追加」を選びます。
4. お問い合わせ内容の選択肢として表示される「項目名」と、その項目を選択したときの送信先となる「メールアドレス」を入力します。
5. 入力し終わったら「保存」を選びます。
{% hint style="info" %}
「保存」を選ぶと、ここで入力した「メールアドレス」に対して確認メールが送信されます。確認メールを受け取れていない場合、ユーザーからのお問い合わせを受け取ることができない可能性があります。メールアドレスの入力内容に間違いがないか確認してください。
{% endhint %}
# PortalDotsでできること(一般モード)
PortalDotsの基本機能のうち、学園祭の参加企画向けの機能について説明します。
一般モードには下記の機能があります。
## 企画参加登録
学園祭への参加登録を行うことができます。企画参加登録の受付期間に限り、参加登録の作成・提出を行うことができます。
{% hint style="info" %}
一般ユーザーが企画参加登録を行えるようにするには、予めスタッフモード内での設定が必要です。詳細は、「[PortalDotsを使って企画参加登録を受け付ける](https://github.com/portaldots/docs/blob/main/4.x/circles/circle-registration.md)」をご覧ください。
{% endhint %}
## お知らせの閲覧
学園祭の参加企画向けのお知らせを閲覧することができます。
{% hint style="info" %}
お知らせを作成・編集する方法については、「[学園祭参加企画向けのお知らせを掲載・メール配信する](https://github.com/portaldots/docs/blob/main/4.x/circles/pages.md)」をご覧ください。
{% endhint %}
## 配布資料の閲覧
学園祭の参加企画向けに配布されている資料(ファイル)を閲覧することができます。
{% hint style="info" %}
配布資料を作成・編集する方法については、「[学園祭参加企画にPDFなどのファイルを配布する](https://github.com/portaldots/docs/blob/main/4.x/circles/documents.md)」をご覧ください。
{% endhint %}
## 申請フォームへの回答
申請フォームに回答することができます。申請フォームの受付期間中であれば、回答済みの申請フォームを編集することもできます。
{% hint style="info" %}
申請フォームを作成・編集する方法については、「[学園祭参加企画からの各種申請をオンラインで受け付ける](https://github.com/portaldots/docs/blob/main/4.x/circles/forms.md)」をご覧ください。
{% endhint %}
## 学園祭実行委員会へのお問い合わせ
学園祭実行委員会に対してお問い合わせを送信することができます。お問い合わせフォームを送信するには、PortalDotsにログインしている必要があります。
{% hint style="info" %}
PortalDotsの機能のうち、学園祭の実行委員(スタッフ)が利用可能な機能については「[PortalDotsでできること(スタッフモード)](/4.x/features/list)」をご覧ください。
{% endhint %}
# 学園祭参加企画を手動でPortalDotsに登録・編集する
学園祭に参加する企画の情報をPortalDotsで管理するために、企画情報をPortalDotsに登録する方法を説明します。また、PortalDotsに登録されている企画情報を編集する方法を説明します。
## 企画情報を手動で登録する必要があるケース
手入力による企画情報の登録は手間がかかるため、PortalDotsでは「企画参加登録」機能を利用することを推奨しています。企画参加登録機能を使えば、各企画の担当者に企画情報を入力してもらうことができます。
それでも、下記の場合では企画情報を手動で登録した方が良いと考えられます。
* PortalDotsの企画参加登録機能以外の方法で企画参加登録を受け付けた場合
* 企画参加登録の受付期間外に、特別対応として企画参加登録を受け付けた場合
{% hint style="warning" %}
PortalDotsでは「企画」は手動で登録できますが「ユーザー」は手動で登録できません。企画に所属するメンバーを登録するには、そのメンバーに対して[PortalDotsのユーザー登録を完了するように依頼する](/4.x/setup/user-registration)必要があります。
{% endhint %}
{% hint style="info" %}
PortalDotsの企画参加登録機能の詳細については、「[PortalDotsを使って企画参加登録を受け付ける](/4.x/features/circle-registration)」をご覧ください。
{% endhint %}
## 企画情報の登録・編集方法
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 企画を新しく登録する場合は「新規企画」を選びます。すでに登録されている企画情報を編集する場合は、編集したい企画の✏️(編集)ボタンを選びます。
4. 以下の表に記載されている入力欄が表示されます。入力欄に入力し終わったら「保存」を選びます。
| 入力項目名 | 説明 |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **企画基本情報** | 企画についての基本的な情報を入力するセクションです。 |
| 企画名・企画名(よみ) | 企画の名前を入力します。 |
| 企画を出店する団体の名称・企画を出店する団体の名称(よみ) | 学園祭に出店する企画を行う団体の名前を入力します。 |
| 使用場所 | 企画が学園祭当日に利用する場所(教室・模擬店ブースなど)を選択します。「場所情報管理」機能で予め作成した場所から選択できます。
PortalDotsの「場所情報」機能の詳細は、「学園祭当日に使用できる場所の一覧や各企画への場所の割り当てを管理する」をご覧ください。
|
| カスタムフォームへの回答 | 「企画参加登録」機能で作成した独自のフォーム(入力欄)への入力内容を編集できます。
PortalDotsの「企画参加登録」機能の詳細は、「PortalDotsを使って企画参加登録を受け付ける」をご覧ください。
|
| タグ | 企画をタグで分類することができます(後述)。 |
| **企画のメンバー** | 企画の責任者・副責任者の情報を入力するセクションです。 |
| 責任者の学籍番号 | 企画の責任者の方の学籍番号を入力します。 |
| 学園祭係(副責任者)の学籍番号 | 企画の副責任者の方の学籍番号を入力します。複数の副責任者がいる場合、1行につき1つ学籍番号を入力でいます。 |
| **参加登録の受理設定** | 企画参加登録を受理したか取り下げたかを入力できるセクションです。この設定を変更すると、その企画のメンバーに対し、企画が受理された(されなかった)旨が記載されたメールが送信されます。 |
| 参加登録の受理設定 | 企画参加登録を受理するかどうかを選択できます(後述)。 |
| 不受理に関する詳細(ユーザーに通知) | (後述) |
| **スタッフ用メモ** | 一般ユーザーには公開されないスタッフ用のメモを入力できます。 |
### 「タグ」について
学園祭への参加形態などに応じて企画をタグで分類することができます。また、企画のメンバーが[閲覧できるお知らせを制限](/4.x/features/pages#orasewonayznitsuite)したり、[回答可能な申請フォームを制限](/4.x/features/forms#fmuhenayznitsuite)したりする目的でもタグを利用できます。
タグ入力欄では、半角スペースで区切ることで複数のタグを設定できます。例えば、講義棟内の教室で企画を出店する企画であり、物品の販売を伴う企画の場合、タグ入力欄では下記の画像のように入力するのがおすすめです。
{% hint style="info" %}
上記の画像の例では「講義棟」と入力していますが、「講義棟教室」などの他の表記でも構いません。ただし、全ての企画を通して表記を統一する必要があります。例えば「講義棟」タグと「講義棟教室」タグは全く別のタグであるとみなされます。
{% endhint %}
### 「参加登録の受理設定」について
企画参加登録を受理したか取り下げたかを設定できます。各企画について「確認中」「受理」「不受理」のうちから1つ設定できます。
| オプション | 説明 |
| ----- | -------------------------------------------------------------------------------------------------------------------------- |
| 確認中 | このオプションを選択すると、企画に所属しているメンバーに対して、企画参加登録の内容が確認中である旨が表示されます。
「企画参加登録」を提出した直後の企画は、全て自動的に「確認中」として設定されます。
|
| 受理 | 企画参加登録の内容を受け入れる場合、このオプションを選択します。
PortalDots「申請」機能で作成した申請フォームに回答できるのは、「受理」として設定されている企画のメンバーのみです。
|
| 不受理 | 企画参加登録を取り下げる場合、このオプションを選択します。
また、「不受理に関する詳細」欄に不受理とした理由を記載することもできます。「不受理に関する詳細」の内容は、不受理となったことを通知するメール内に表示されます。
|
{% hint style="info" %}
「登録受理状況」を「受理」または「不受理」にチェックを入れると、その企画のメンバーに対し、企画が受理された(されなかった)旨が記載されたメールが送信されます。
{% endhint %}
# フォームエディターで申請フォームを作成する
PortalDotsで公開する申請フォームを作成するには「フォームエディター」を利用します。企画参加登録フォームに独自の入力欄を作成する場合もフォームエディターを利用します。
## 概要
PortalDotsの「フォームエディター」を利用すると、プログラミング不要の直観的な操作で申請フォームを作成することができます。
{% embed url="" %}
フォームエディター
{% endembed %}
## フォームエディターを起動する
既に作成済みの申請フォームを編集したい場合や、企画参加登録フォームに追加した独自の入力欄（カスタムフォーム）を編集したい場合、次の方法でフォームエディターを起動することができます。
### 申請フォームを編集する
1. 「スタッフモード」を開きます。
2. メニューから「申請管理」を選びます。
3. 編集したいフォームの✏️(編集)ボタンを選びます。
4. 「フォームエディターを開く」を選びます。
### 企画参加登録フォームの独自の入力欄(カスタムフォーム)を編集する
1. 「スタッフモード」を開きます。
2. メニューから「企画情報管理」を選びます。
3. 「企画参加登録機能の設定」を選びます。
4. 「企画参加登録機能を有効にする」ボタンが表示されている場合、「企画参加登録機能を有効にする」ボタンを選びます。
5. 「フォームエディターを開く」を選びます。
## 設問(入力欄)をフォームに追加する
フォームエディターの画面右側にある「設問を追加」サイドバーから、フォーム内に設問(入力欄)を追加することができます。
| 設問タイプ | 説明 |
| -------------- | ---------------------------------------------------------------------------------- |
| セクション見出し | 複数の設問をセクションにまとめることができます。この設問タイプには入力欄がありません。見出しとして利用できるほか、フォーム内に説明文を表示する目的でも利用できます。 |
| 一行入力 | 1行だけ入力できる入力欄(テキストボックス)です。 |
| 整数入力 | 整数を入力できる入力欄(テキストボックス)です。数字以外の文字を入力することはできません。 |
| 複数行入力 | 入力内容に改行を含めることができる入力欄(テキストボックス)です。 |
| 単一選択(ラジオボタン) | 複数の選択肢から1つだけ選択できる入力欄です。 |
| 単一選択(ドロップダウン) | 複数の選択肢から1つだけ選択できる入力欄です。 |
| 複数選択(チェックボックス) | 複数の選択肢から2つ以上選択できる入力欄です。 |
| ファイルアップロード | ファイルをアップロードできる入力欄です。 |
## 設問を編集する
フォームエディターに追加した設問をクリックすると、その設問に関する情報を編集することができます。設定可能な項目は、設問タイプによって異なります。
### 全設問タイプ共通の設定項目 (セクション見出しを除く)
| 設定項目 | 説明 |
| ----- | ----------------------------------------------------- |
| 回答必須か | 回答を必須とする場合はオンにします。回答必須の設問が未回答の場合、申請フォームを提出することができません。 |
| 設問名 | 入力欄の名前として表示するテキストを入力します。 |
| 説明 | 入力欄の説明として表示するテキストを入力します。 |
### セクション見出し
| 設定項目 | 説明 |
| ---- | ---------------------- |
| 見出し | 見出しとして表示するテキストを入力します。 |
| 説明 | 見出しの下に表示されるテキストを入力します。 |
### 一行入力・複数行入力
| 設定項目 | 説明 |
| ----------- | -------------------- |
| 最小文字数・最大文字数 | 入力欄に入力できる文字数を制限できます。 |
### 整数入力
| 設定項目 | 説明 |
| ------- | --------------------------- |
| 最低数・最大数 | 入力欄に入力できる数値の最小値・最大値を制限できます。 |
### 単一選択(ラジオボタン)・単一選択(ドロップダウン)
| 設定項目 | 説明 |
| ---- | ------------------------------------------------------- |
| 選択肢 | 選択肢として表示する内容を入力します。複数の選択肢から選択させる場合、1行につき選択肢を1つ入力してください。 |
### 複数選択(チェックボックス)
| 設定項目 | 説明 |
| ----------- | ------------------------------------------------------- |
| 選択肢 | 選択肢として表示する内容を入力します。複数の選択肢から選択させる場合、1行につき選択肢を1つ入力してください。 |
| 最小選択数・最大選択数 | チェック可能な数を制限できます。 |
### ファイルアップロード
| 設定項目 | 説明 |
| --------- | -------------------------------------------------------------------------- |
| 最大サイズ(KB) | アップロード可能なファイルサイズをキロバイト(KB)単位で制限できます。 |
| 許可される拡張子 | アップロード可能なファイルの拡張子を指定できます。**「許可される拡張子」が未設定の場合、ユーザーはファイルをアップロードすることができません。** |
# Markdownガイド
このページでは、Markdown記法のうち、よく利用されるものを紹介します。
## Markdownについて
PortalDotsでは、お知らせの本文などをMarkdown記法で書くことができます。PortalDotsでMarkdown記法を使える入力欄には、下記のように「Markdown」と表示されています。
## 見出し
行の先頭に `#` 記号と半角スペースを入れると、その行は見出しとなります。 `#` の数が多いほど小さな見出しになります。
```
# これは大きい見出し(h1)です
## これは見出し(h2)です
### これは見出し(h3)です
#### これは見出し(h4)です
##### これは見出し(h5)です
###### これは見出し(h6)です
```
上記のように書くと、下記のように表示されます。
## 箇条書き
行の先頭に `*` 記号と半角スペースを入れると、その行は箇条書きとなります。 \* の前に半角スペースを2つ以上入れると段下げできます。
```
* 箇条書き1
* 箇条書き2
* 箇条書き2-1 — * の前に半角スペースを2つ以上入れると段下げできます
* 箇条書き2-2
* 箇条書き3
```
上記のように書くと、下記のように表示されます。
## 番号付きリスト
行の先頭に `1.` と半角スペースを入れると、その行は箇条書きとなります。 `1.` の前に半角スペースを2つ以上入れると段下げできます。
```
1. 最初の項目
1. 次の項目
1. 子項目a — 1. の前に半角スペースを2つ以上入れると段下げできます
1. 子項目b
1. 最後の項目
```
上記のように書くと、下記のように表示されます。
## 太字
太字にしたい部分を `**` 記号で囲みます。
```
**ここ**が太字になります
```
**ここ**が太字になります
## 取り消し線
取り消し線を引きたい部分を `~~` 記号で囲みます。
```
~~ここ~~に取り消し線を引きます
```
~~ここ~~に取り消し線を引きます
## リンク
下記のように、 `[リンクとして表示する文字](URL)` という形でリンクを作成できます。
```
[ここをクリック](https://www.portaldots.com)するとPortalDotsのウェブサイトにアクセスします
```
[ここをクリック](https://www.portaldots.com)するとPortalDotsのウェブサイトにアクセスします
## 引用
行の先頭に `>` と半角スペースを入れると、その行は引用の表示となります
```
> 一人ひとりの「想い」をつなぎ、学園祭を最高に楽しくする
```
> 一人ひとりの「想い」をつなぎ、学園祭を最高に楽しくする
## 表(テーブル)
```
| 列1 | 列2 | 列3 |
| --- | --- | --- |
| John | Doe | Male |
| Mary | Smith | Female |
```
# PortalDotsの開発に貢献する
PortalDotsの開発に興味を持ってくださりありがとうございます。PortalDotsはGitHub上で公開しているオープンソースプロジェクトです。プロジェクトをより良くするための提案（不具合報告・改善案・Pull Request）などがありましたらぜひお寄せください。
PortalDotsでは、「作る人」と「使う人」という関係性に留まらず、みんなでPortalDotsを盛り上げていく形が理想だと思っています。みなさまのご協力をよろしくお願いいたします。
## 貢献の方法
PortalDotsにおける改善要望・不具合報告、Pull Requestの作成方法や取り扱いについては、[コントリビューションガイドライン](https://github.com/portaldots/PortalDots/blob/4.x/CONTRIBUTING.md)をご覧ください。
{% hint style="info" %}
PortalDotsマニュアル(このサイト)は、PortalDotsソフトウェア本体と同様、GitHub上で公開しているオープンソースプロジェクトです。詳細は、[「PortalDotsマニュアル」の作成に貢献する](/4.x/contributing/how-to-contribute-to-docs)をご覧ください。
{% endhint %}
## 関連リンク
* [PortalDotsのGitHubリポジトリ](https://github.com/portaldots/PortalDots)
* [README](https://github.com/portaldots/PortalDots#readme)
* [コントリビューター行動規範](https://github.com/portaldots/PortalDots/blob/4.x/CODE_OF_CONDUCT.md)
* [コントリビューションガイドライン](https://github.com/portaldots/PortalDots/blob/4.x/CONTRIBUTING.md)
* [Issues](https://github.com/portaldots/PortalDots/issues)
* [Pull requests](https://github.com/portaldots/PortalDots/pulls)
* [Discussions (フォーラム)](https://github.com/portaldots/PortalDots/discussions)
* [ライセンス(MIT License)](https://github.com/portaldots/PortalDots/blob/4.x/LICENSE)
# PortalDotsのディレクトリ構造
PortalDotsを構成するディレクトリ構造を説明します。
[PortalDotsのGitHubリポジトリ](https://github.com/portaldots/PortalDots)は、以下のディレクトリ構造を持ちます(2022年4月現在)。
PortalDotsは、主にLaravelとVue.js(バージョン2)、SCSSを利用しています。
{% hint style="warning" %}
Laravelのモデルは、一般的に`app/Models`ディレクトリに格納しますが、PortalDotsでは`app/Eloquents`ディレクトリに格納しています。
{% endhint %}
```
.
├── .github
│ ├── workflows CIの実行やリリースZIPファイルの作成のためのGitHub Actionsワークフロー。
├── app Laravelのアプリケーションディレクトリ。
│ ├── Auth
│ ├── Console
│ ├── Eloquents モデル。Laravel標準のフォルダ(Models)とは異なるので注意。
│ ├── Exceptions
│ ├── Exports CSVエクスポート/インポート機能。
│ ├── GridMakers スタッフモード内に表示する各種一覧表示の定義。
│ ├── Http
│ │ ├── Controllers コントローラー。原則として1コントローラにつき1アクションのみ。
│ │ ├── Middleware
│ │ ├── Requests フォームリクエストクラス。バリデーション処理は原則ここに書く。
│ │ └── Responders
│ ├── Mail
│ ├── Notifications
│ ├── Policies
│ ├── Providers
│ └── Services サービスクラス。データベースを操作する処理をここに書くことがある。
├── bootstrap
├── config
├── cron
├── database
│ ├── factories
│ ├── migrations
│ └── seeders
├── docker_dev
├── patches npmパッケージにパッチを当てるために利用。
├── resources
│ ├── img
│ ├── js
│ │ ├── forms_editor フォームエディター用のJavaScriptファイル。Vue.jsを使用。
│ │ └── v2 フォームエディター以外のJavaScriptファイル。Vue.jsを使用。
│ ├── lang
│ ├── sass
│ │ └── v2 主なスタイルはこのフォルダ内に書く。
│ └── views ビューファイル。原則としてコントローラのアクション1つにつき1ファイル。
└── routes ルーティング定義ファイル。スタッフモードと一般モードでファイルを分けている。
```
# 「PortalDotsマニュアル」の作成に貢献する
「PortalDotsマニュアル」(このサイト)のコンテンツ作成・維持管理にご協力お願いいたします。
「PortalDotsマニュアル」の改善に興味を持ってくださりありがとうございます。
「PortalDotsマニュアル」は、PortalDotsの使い方を紹介するウェブサイトです。「PortalDotsマニュアル」のコンテンツはPortalDots本体と同様、[オープンソース](https://github.com/portaldots/docs/blob/main/4.x/LICENSE/README.md)です。コンテンツはMarkdown形式で管理しています。また、コンテンツ改善案や追加の要望を、GitHubのPull Request機能にて受け付けております。
PortalDotsコミュニティの発展のため、マニュアルの作成・維持管理に協力いただけますと幸いです。
{% hint style="info" %}
PortalDotsマニュアルのウェブサイトは、[GitBook](https://www.gitbook.com)(Communityプラン)上でホストしています。
{% endhint %}
## 既存の記事の内容を修正を提案する
GitHubのPull Request機能により、既存の記事内容の改善提案を受け付けております。
1. (パソコンの場合)改善提案を作成したい記事の画面右側に表示されている「GitHubで編集」をクリックします。(スマートフォンの場合)画面右上にある…をタップし、「GitHubで編集」を選択します。
2. GitHubリポジトリ上の当該記事ファイルが表示されます。 "Edit this file" を選択してください。
3. コンテンツ内容を修正します。
4. 画面下部の "Commit changes" にて変更内容の説明を記載し、Pull Requestを作成してください。
## 新しい記事の追加を提案する
PortalDotsマニュアル上に存在しないページの作成を提案したい場合は、「[マニュアル記事の新規作成提案(GitHub)](https://github.com/portaldots/docs/tree/main/4.x/_drafts)」をご覧ください。
{% hint style="warning" %}
`_drafts` フォルダ以外のフォルダへのページ作成は受け付けていません。
{% endhint %}