"バージョン2.50以降では、config.xmlファイルを使用してプラグインファイルを自動的に読み込むことができます。1,052:バージョン2.50以降では、config.xmlファイルを使用してプラグインファイルを自動的に読み込むことができます。バージョン2.50以降では、config.xmlファイルを使用してプラグインファイルを自動的に読み込むことができます。enclose="div"><css>+*/{your_template}/config.xmlで、<css>ブロックまたは<js>ブロックにファイルパスを追加します。追加)はじめにLimeSurveyには、アンケートの外観を効率的にカスタマイズできる高度なテーマとスタイルのシステムがあります。LS3以降、以前のバージョンで"テンプレート"と称していたものを"テーマ"と呼びます。テーマは、アンケート中のページの見た目をコントロールします。アンケート管理者は、既定のテーマを選択し、個々のアンケートをカスタマイズし、見た目を改善することができます。テーマには、プログラミングのスキルを要することなく、ようこそ画面にロゴを追加したり、背景色を変更したり、フォントを選択したりできるオプションがあります。LimeSurveyには、初期状態で3つのテーマがあります。これらの初期テーマは、"themes/survey/"ディレクトリーにあります。それぞれのテーマは個々にディレクトリーを持っています。.png)など多くのディレクトリーがあります。3は標準的なフレームワークなので、開発者はインターネットで関連のドキュメント、チュートリアル、フォーラムスレッドを利用することができます。3以降、テーマエンジンは、Twigを使用しており、テーマ開発者は安全かつ簡易な方法でアンケートレンダリングのロジックを変えることができます。Twigは、以前のバージョンで使われていた置換キーワードシステムに代わるものです。キーワードのHTMLを生成するために使用されるロジックは、テーマビューの中で利用できます。}}</div>テーマは、HTMLとTwigコードからなり、表示されるテキストの位置と形式、ページの同様の構造的特徴を定義します。テーマには他のファイルを参照したり取り込んだりすることが多くあります。ほとんどの場合、アンケートのすべてのページで共通に利用するフォントスタイル、色、背景や同様のパラメーターについて定義したカスケーディング・スタイル・シート(CSS)ファイルを参照します。スタイルシートは、HTMLコードに含まれる様々なオブジェクトタイプに関連づけられたクラスパラメーターを参照します。これにより、スタイルシートは、複数の場所に現れるテキストや他のオブジェクトをどのように表示させるかを記述できます。LimeSurveyでは質問タイプごとに固有のクラスがあり、それぞれの見た目を細かく規定することができます。ロゴや進捗バーで使用する画像ファイルもテーマファイルの中で参照されます。最後に、中括弧に挟まれた特別なキーワードは、対応する言語の翻訳として定義されたテキストに置き換えられます(例えば、それぞれの言語で書かれた'アンケートタイトル'、'質問文'など)。新しいカスタムテーマを作成したら、LimeSurveyコミュニティーに共有し、他の人が使えるようにすることを検討してください。あなたの貢献によって、テーマ、アンケート、その他のアドオンが豊富になり、LimeSurveyがよりよいものになります。テンプレートの共有については、LimeSurveyテンプレートリポジトリーを参照してください。新しいテーマを作成する(既存のテーマを編集する)には、LimeSurveyでテーマ編集ユーザー権限を設定する必要があります。LimeSurveyをインストールしているOSのファイル操作権限も併せて設定します。テーマを変更した場合、LimeSurveyにすでに存在するアンケートに影響を及ぼす可能性があります。テーマは、円滑に利用するためにHTMLの知識と経験を必要とする高度な機能です。新しいテーマを作成するには、設定ダイアログにあるテーマエディター(下記参照)を通じて行うのが望ましいやり方です。ウェブインターフェースではなく、お気に入りのテキストエディターを使ってテーマファイルを編集したい人もいるでしょう。この場合でも、新しいテーマを作成するときはテーマエディターを使います。これにより、LimeSurvey_web_root/upload/themes/survey/your_new_templateディレクトリーに必要なすべてのファイルが配置され、基礎となるテーマが作成されます。この後、好みのテキストエディターを使ってテンプレートファイルを編集することができます。unix/linuxシステムでは、ウェブサーバーを起動しているグループやユーザーがテーマファイルのオーナーになっています(いくつかのシステムでは"www"かもしれません)。したがって、ファイルを編集するときは十分なアクセス権があるか確認するとともに、保存するときは所有権を変えないように注意しましょう。このようにすれば、ウェブのテーマ編集インターフェースを使うことができます。LimeSurveyの'public'エレメントの多くはテーマによって調整することができます。次のセクションでは、テーマテンプレートについて簡単に説明します。テーマファイルは複雑です。HTMLのほか、CSS、Twig、JavaScriptについて理解している必要があります。管理ツールバーからテーマエディターを利用することができます。テーマエディターは、テンプレートパーミッションを有するユーザーとスーパー管理者だけが利用することができます。テーマが正しく構成されていない場合、そのテーマを利用しているアンケートは、正常に動作しません。LimeSurveyテーマエディターは、テーマのコンテンツをオンラインで編集できます。テーマエディターを起動するには、設定メニューのテーマリンクをクリックし、編集したいテーマの隣にある"テーマエディター"ボタンをクリックします。テンプレートエディターページでは、編集/閲覧したいテンプレートを選択します。下記のオプションが使用できます。新しいテンプレートを作成します。ゼロから作るのでなければ、'default'がコピーされます。ZIPファイルでテンプレートをインポートします。現在のテンプレートをZIPファイルにエクスポートします。現在のテンプレートを新しいテンプレートとしてコピーします。テンプレートの名前を変更します。通常、コピーやインポートした後に使います。LimeSurveyで利用できる状態にあるテンプレートをドロップダウンリストで表示します。at.管理パネルに戻る.テンプレートのインポート/エクスポート/コピーテンプレートをエクスポートするとき、テンプレートを構成するすべてのファイル(.pstplファイル、画像、cssファイルなど)がアーカイブされたZIPファイルが生成されます。エクスポートしたZIPファイルをインポート機能を使って他のLimeSurveyにインポートするか、他のLimeSurveyに手動でコピーして対応するテンプレートディレクトリーに展開します。インポート/エクスポート/コピー機能を使うことを推奨します。startpage.pstpl、assessment.pstpl、completed.pstpl、endpage.pstplテンプレートファイル以下のテンプレートファイルは、アンケート作成時に使用され、新たに作成したテンプレートフォルダーになければなりません。HTMLページのスタート部分を形成します。"<head>"タグで始まります("<html>"タグを含んではなりません)。この、標準的なHTMLページの'冒頭部分'はスクリプトで書かれています。startpage.pstplファイルには<body>タグを含めます。HTML標準に厳格に従わないことも許容していますが、LimeSurveyスクリプトでは、JavaScriptエレメントを実行するため、<body>タグがなければなりません。startpage.pstplファイルに、多くの'キーワード'を入れる必要はありませんが、タイトルに{SURVEYNAME}を入れたいと思うでしょう。startpage.pstplファイルには、対応するendpage.pstplファイルで閉じるコードを入れることができます。このファイルでテーブルを開始し、endpage.pstplファイルで閉じるような場合です。LimeSurveyで使用されるあらゆるページはstartpage.pstplとendpage.pstplファイルに挟まれます。このテンプレートは、ほとんどのページで使用されるもので、アンケートの名前と説明を表示させます。このテンプレートは、対応する'閉じる'テンプレートはなく、このテンプレートファイルで開いたタグはすべてこのファイルの中で閉じなければなりません(例えば、閉じるものがなくなるので、テーブルを開いたままにしてはいけません)。このテンプレートはようこそ画面で使用されます(全体が1ページで構成されるアンケート画面を含みます)。歓迎のテキストのほか、アンケートを始める前に提供すべき情報を表示できます。'survey.pstpl'と同様、対応する'閉じる'テンプレートはないので、このテンプレートファイルで開いたタグは同様に閉じなければなりません。このテンプレートは、グループの質問をくるむものです。このファイルで開いたタグを閉じることができる'endgroup.pstpl'テンプレートがあるので、この中でテーブルを開くことができます。このテンプレートファイルは、グループの説明を表示するために使用します。アンケート設定(プレゼンテーションタブの表示とナビゲーション設定からアクセス)によって、グループ説明を表示するかどうかが決まります。表示しない設定の場合、このファイルは無視されます。このファイルは、アンケートの質問、回答、ヘルプテキストから構成されます。"グループごと"と"一括"型のアンケートでは、このテンプレートは質問ごとに繰り返されます。対応する'閉じる'ファイルがないので、すべてのタグを閉じる必要があります。このファイルには、質問の初めに表示される個々のエレメントが含まれます。{QUESTION}キーワードによって、'question.pstpl'ファイルに取り込まれます。これは、テンプレートデザイナーが質問のレイアウトをもっとコントロールしたい場合に使用します。1.87以降置き換えられています。このテンプレートのキーワードは、question.pstplで直接利用できます。このページは、アンケートの回答が保存され、アンケートが終了したときに、最終ページとして表示されます。アンケート設計時に設定した"転送リンク"を表示する場合に使用します。このファイルはグループを閉じるもので、startgroup.pstplファイルで開いたすべてのタグを閉じます。このファイルには、アンケートをナビゲートするための"次へ"、"前へ"、"最終"、"送信"、"保存"、"クリア"ボタンが含まれます。最終ページ以外のすべてのページで使用されます。このファイルには、アンケートの印刷バージョンで必要なHTMLラッパーが含まれます。このファイルはstartgroup.pstplとendgroup.pstplファイルと同様で、印刷バージョンで使われます。このファイルはquestion.pstplと同様で、印刷バージョンで使われます。このファイルはsurvey.pstplと同様で、印刷バージョンで使われます。CSSとJavascripttemplate.css(CSS用)とtemplate.js(Javascript用)の二つは、テンプレートで必ず使われます。既定のCSSであるtemplate.css(RTL言語ではtemplate-rtl.css)へのリンクに置き換えられます。既定のJavascriptファイルであるtemplate.jsとLimeSurveyに必要なすべてのjsファイルへのリンクに置き換えられます。3を組み込んでいるので、正しく記述されたBootstrapクラスによってテンプレートにスタイルを適用することができます。詳細は、Bootstrapドキュメントを参照してください。Awesome-Bootstrap-Checkboxプラグインも組み込まれています。これにより、Bootstrapのcolor-class(info、warning、dangerなど)と"-checkbox"や"-radio"で終わるクラスを使い、チェックボックスやラジオボタンを好きなデザインにすることができます。既定のCSS、Javascriptを置き換える特別なJavascript、CSSファイルを使用することができます。functionを置き換えたい場合は、カスケードシステムを使用します。Javascriptのfunctionでは、最後に読み込まれたものが使用されます。その他のテンプレートファイルprivacy.pstpl、invitationemail.pstpl、reminderemail.pstpl、confirmationemail.pstplはLimeSurveyではもう使われておらず、既定値は言語ファイルに収録されています。メールメッセージはアンケートごとに編集することができるようになりました。標準ページアンケート参加者がLimeSurveyのアプリケーションにアクセスするときに目にする標準ページが10個あります。それぞれ、アンケートの設定で指定したテンプレートの共通のファイルから構成されます。次の表はどのテンプレートファイルがそれぞれのページを構成するかを示したものです。バージョン1.90+では、question.pstplとquestion_start.pstplが置き換えられています。古いカスタムテンプレートを使用している場合は、question.pstplの初めに次の行を追加します。class="{QUESTION_CLASS}{QUESTION_MAN_CLASS}{QUESTION_INPUT_ERROR_CLASS}">さらに、question.pstplの終わりに対応する閉じるタグを追加します。バージョン1.91以前では、LimeSurveyのjsファイルはテンプレートに含まれません。バージョン2では、jsファイルにリンクさせるため、テンプレートファイルのひとつに{TEMPLATEJS}を入れなければなりません。startpage.pstplかendpage.pstplに追加することができます。{TEMPLATEURL}/template.jsの行を削除し、パーソナルテンプレートを更新するため、{TEMPLATEJS}に置き換えなければなりません、ファイルコントロールセクション左側の"ファイルコントロール"ウィンドウで、ページを編集するために使われるテンプレートファイルをクリックします。画面パーツ、JavaScript、CSSファイルがあります。そのファイルの中央のHTMLコードが"編集中"ウィンドウに表示されます。テンプレートが編集可能な場合(ディレクトリーに設定された権限による)、好きなように変更して保存することができます。"その他のファイル"ウィンドウでは、テンプレートディレクトリーにあるその他のファイルの一覧が表示されます。右側からテンプレートを作成するために必要な画像ファイル(画像、ロゴなど)やその他のファイルのアップロードや選択ができます。それぞれの画像へのリンクを使わずに、{TEMPLATEURL}という文字列を使います。src='{TEMPLATEURL}files/mypicture.jpg'LimeSurveyのバージョン2.50以前では、次のようにします。src='{TEMPLATEURL}mypicture.jpg'編集中のテンプレートページの"例"は、画面下部に表示されます。テンプレートエディタでテンプレートを削除することはできません。ディレクトリーにアクセスし、そこから手動でファイルを削除する必要があります。テンプレートの見た目をさらに評価するため、他の画面解像度を選択することもできます。同梱のテンプレートはテンプレートエディターで編集することはできません。編集する場合は、コピーを作成し、それを編集します。テンプレートファイルの場所LimeSurveyでは、他のpublicファイルが格納されているpublicディレクトリーに"/templates"ディレクトリーがあり、その中のテンプレートごとのサブディレクトリーに個々の'標準'テンプレートが格納されています。カスタマイズされたユーザーテンプレートは、/upload/templatesディレクトリーに格納されています。テンプレートディレクトリーには、必ず"default"ディレクトリーがあります。このテンプレートは、既定として使われ、テンプレートフォルダーが見つからない場合の代理として使用されます。デフォルトでインストールされています。次の構文を使用して、テンプレート管理領域にアップロードした画像ファイルを使用することができます。{TEMPLATEURL}filename.xyzCSSによる質問のスタイリングCSSによる質問のスタイリングは簡単になりました。それぞれの質問タイプには固有のクラスがあります。必須の質問は更に必須項目としてのクラスがあります。mandatory">...</div>となります。input-error">...</div>となります。質問に検証が適用され、回答が正しくない場合、次のようになります。input-error">...</div>質問パート全体のクラスこのクラスはすべての質問タイプで使用されます。質問タイプにより、一つまたは複数のクラスが使われます。.questions-listも使われます。回答なしも回答であり、noanswer-itemとanswer-itemの2つのクラスを持ちます。質問でもある回答があります。answer-item"となるものが多数あります。text-list"のように、multi-listクラスを使用する質問タイプがあります。CSSにより非表示となりますが、スクリーンリーダーが読み上げます。2.50以降は、bootstrapのsr-onlyを使用できます。他の目的で利用します。LimeSurveyのコアで使用されていますが、テンプレートの中でも使用できます。jsが有効な場合に非表示となりますが、スクリーンリーダーを利用する場合は常に表示されます。LimeSurveyのコアで、JavaScriptが有効でない場合に非表示のリンクで使用されています。配列質問タイプのテーブル内のラベルで使用します。追加)bootstrapのinput-group-addonと同じ利用方法ですが、枠線と背景がありません。最新のブラウザーでは必要ありませんが、古いブラウザーでは必要となります。最新のブラウザーでは必要ありませんが、古いブラウザーでは必要となります。1.92以前で使用できるクラスは、.mandatoryと.input-errorのみです。これらは、ヘルプと検証TIPメッセージに適用され、タイプごとにスタイリングできます。既定では、.hide-tipと.input-errorは連動しており、検証TIPを非表示にしておくことができます。検証エラーが発生するとTIPが現れ、エラーが解消されると再び非表示になります。これらは、ポップアップの警告メッセージの必要性をなくすためにデザインされています。代わりに、必要に応じてTIPが表示され、回答が検証式に適合したかどうかを表示色で示します。ページを開いたばかりの未回答状態で検証条件を満たさない場合は、検証条件を満たしていない旨のTIPはやさしい色で表示される一方、回答を送信して検証エラーが発生した場合は注意を促す色付けで表示されます。other_comment_mandatoryオプション向け("その他"が選択されているがコメントがない場合に表示される)カスタムテンプレートにスタイルをインポートするカスタマイズされた質問のスタイルは、それぞれのテンプレートのCSSファイルの最後のほうにあり、次の記述から始まります。*/カスタムテンプレートの他のスタイルに影響を与えずにスタイルを適用する場合は、templates/default/template.css(テーブルベースのレイアウトの場合)と/templates/limespired/template.css(CSSベースのレイアウトの場合)の中にある上記の行の後のすべての記述を独自のスタイルシートにコピーしなければなりません。Explorer向けの条件付きスタイルシートIE6・IE7とその他のブラウザーの間のレンダリングには著しい違いがあるため、各テンプレートにはIE向けの特別な条件付きスタイルシートがあります。startpage.pstplの中、/templates/default/または/templates/limespiredからテーブルベースのレイアウト用とCSSベースのレイアウト用のそれぞれのIEスタイルシートのコピーに入れます。独自のスタイルシートにスタイルをコピーする場合、ほとんどの場合、調整を加える必要があります。explorer向けの別のソリューションbodyの条件付きクラスをstartpage.pstplに配置し、このクラスをtemplate.cssで使用できます。2.06)で使用されます。JavaScriptが動作するシステムにはjsクラス、動作しないシステムにはno-jsクラスを追加します。})(document.getElementsByTagName('body')[0]);/*]]>*/</script>また、template.cssでは次のように使用します。*/}右から左に記述する(RTL)言語と均等割り付けLimeSurveyのテキストエディターは、RTLテキストを書式設定できます。エディター自体は、均等割り付けしたときにRTL言語を左から右の形式で表示します。これはエディターの表示上の問題です。RTLで均等割り付けされた質問またはテキストは、アンケートやプレビューでは正しく右から左に表示されます。この機能はバージョン3.0では非推奨です。テンプレートファイル内のキーワードは、現在のアンケート情報に置き換えられます。中括弧で囲まれています(例:{SURVEYNAME})。次の文字列は、テンプレートファイルを解析してアンケートユーザーに提示するときにLimeSurveyに置き換えられます。これらのフィールド文字列は、'完了ページ'以外のほぼすべてのテンプレートで機能します。(これらの文字列のほとんどはcommon.phpファイルにありますが、そこにない場合はindex.phpファイルを見てください。現在のグループ名を表示します。現在のグループの説明を表示します。アンケートの質問総数(数字のみ)を表示します。関連する言語ファイルから"このアンケートはX問あります"という文が表示されます。Xは質問の数で置き換えられます。これは、単数形または複数形に対しても適切に機能します。質問が1つしかない場合、"このアンケートは1問あります"と表示されます。(LS1.87から置き換えられました)現在の質問のテキストを表示します({QUESTION}の書式は、'question_start.pstpl'を編集することによってカスタマイズできます)。現在の質問に対する回答フォームを表示します。現在の質問のヘルプテキスト(質問タイプごとにあらかじめ決められたヒント)を表示します。各質問タイプに固有のクラスです(質問を包含するタグに含められます)。現在の質問コードを表示します。質問IDと(条件付き質問の場合)、'style="display:none;"'(質問を包含するタグに含められます)。現在の質問に対しユーザーが定義したヘルプテキストを表示します。現在の質問に対しユーザーが定義したヘルプテキストを表示します。ユーザー入力エラーがあった場合に適用されるクラスです。個別の質問のスタイリングを可能にするために、各質問に一意のIDを付与します。現在の質問のテキストを表示します。現在の質問に関する翻訳された'必須'テキストを表示します。質問が必須の場合のクラスです(質問を包含するタグに含められます)。現在の質問に関する翻訳された'必須'ヘルプメッセージテキストを表示します。現在の質問に関する翻訳された'有効'ヘルプメッセージテキストを表示します。条件付き質問の'シナリオ'テキストを印刷します。"結果を破棄して終了"リンクを表示します。登録時の'完了'メッセージを表示します(attribute_1フィールドとattribute_2フィールドが設定されているかどうかによって変化)。text'を表示します。アンケートを匿名に設定すると、プライバシーメッセージが表示されます。テキストは、言語ファイルで編集・翻訳することができます。privacy.pstplテンプレートを編集して手動で変更することもできます。現在のテンプレートの場所へのURLです(テンプレート内の画像ファイルを参照するのに便利)。このアンケート用の現在のアップロードファイルのURLです(質問、グループなどの画像ファイルを参照するのに便利です)。アンケートを完了したこととと、"送信"ボタンを押すようユーザーに知らせる(言語ファイルの)メッセージ。ユーザーの'回答ID'を表示します。PDFをエクスポートするボタンを表示します。***アンケート回答が匿名でない場合、トークンテーブルのユーザーの名に置き換えられます。***アンケート回答が匿名でない場合、トークンテーブルのユーザーの姓に置き換えられます。***アンケート回答が匿名でない場合、トークンテーブルのユーザーのメールアドレスに置き換えられます。***アンケート回答が匿名でない場合、トークンテーブルのユーザーのattribute_1に置き換えられます。***アンケート回答が匿名でない場合、トークンテーブルのユーザーのattribute_2に置き換えられます。"回答の消去"メッセージ。アンケートを再開するURL。登録ページにエラーメッセージが表示されます(例えば、"メールアドレスを入力する必要があります")。言語ファイルの"のアンケートを実施するには、登録を行う必要があります。