Pdfリンク プラグイン

概要

Pdfリンクプラグインは、ブログ記事の本文の代わりににPDFファイルを表示できるbaserCMS専用のプラグインです。

本プラグインはarata氏（http://www.materializing.net/）のKeywordプラグインを元に作成しました。

インストール方法

1. 圧縮ファイルを解凍後、BASERCMS/app/plugins/Pdf に配置します。
2. 管理システムのプラグイン管理に入って、表示されている Pdfリンクプラグイン を有効化して下さい。
3. プラグインの有効化後、固定ページ編集画面とブログ記事編集画面にアクセスすると、入力項目にPDFファイル設定欄が追加されます。
4. PDFファイルは、/app/Upload/pdf/に格納されます。格納ディレクトリを変更するときは、/app/plugin/Pdf/Config/pdf.php を変更してください。

設定方法

ブログプラグインの「プログ設定編集」で、ブログごとにPDFファイルの設定ができます。

設定項目	機能
PDFファイル公開	プログ記事からのPDFファイルリンクを有効・無効を設定します。
PDFファイル優先	ブログ記事本文（HTML）とPDFファイルの両方を指定されていた場合に、どちらを優先して表示するかを指定します。

各ブログ記事の「記事編集」で、PDFファイルをリンクさせます。編集アイコンからPDFファイル設定ページに行って、PDFファイルを選択してください。

PDFファイルは、Webブラウザからアクセスできないサーバーの/app/Upload/pdf/ディレクトリにアップロードします。アップロードできるPDFファイサイズは、サーバーの設定によります。memory_limit, post_max_size, upload_max_filesize の値を調整して下さい。

表示方法

PDFファイルの表示

指定されたPDFファイルの表示をします。

{baserCMSのURL}/pdf/pdf/show/{コンテンツID}/{ブログ記事ID}/

PDFファイルが設定されていない場合は、ブログ記事の表示にリダイレクトされます。

ヘルパーの利用

指定されたブログのコンテンツIDで指定して、PDFファイルにリンクしたタイトル一覧を表示します。

$this->BcBaser->pdfTilteList($contentsName, [$num]，[$options])

• string $contents プログコンテンツ名をアルファベットで指定します。
• int $num 記事件数。初期値：5。 0を指定するとすべての記事を表示します。
• array $options 抽出条件を仮想配列で指定する。
• year 年で抽出する。4桁の年を指定する。
• target リンクのターゲット指定をする。aタグのtarget属性と同じ動作をする。何も設定しないと、通常通り現在のウィンドウに表示し、指定するとその名前のウィンドウに（なければ生成して）表示する。_blankを指定すると新規のウィンドウに表示する。

例）

<?php $this->BcBaser->pdfTilteList('news', 10, array('year' => '2014', 'target' => 'hoge')) ?>

Ajaxでの更新

Ajaxでの更新を行うための年ごとにブログタイトルを取得するアクションを用意しました。

/pdf/pdfConfigs/ajax_getTitleList/[コンテンツID]

• コンテンツID int ブログのコンテンツIDを指定します。

POST送信するデータに以下を指定してください。

• Year string　抽出する年を指定します。
• Taeget string リンクのターゲット属性を指定します。

例）2000年から今年までのバックナンバーリンクを用意して、クリックするとタイトル一覧を更新します。タイトルをクリックすると、別ウィンドウでPDFファイルをオープンします。

<?php $this->Html->scriptStart(array('inline'=>false)); ?>
$(function() {
	$(".linkBackNumber").on('click', function(){
		var year = $(this).attr('year');
		$.ajax({
			url: "/pdf/pdfConfigs/ajax_getTitleList/1",
			type: 'POST',
			data: {'Year' : year, 'Target': 'hoge'},
		}).done(function(data){
			$('#HogeList').html(data);
		}).fail(function(data){
			alert('エラーが発生しました。');
		});
	});
});
 <?php $this->Html->scriptEnd(); ?>

 <div id="HogeList">
<?php $this->BcBaser->pdfTilteList('ir', 0, array('year' => date("Y"), 'target' => 'hoge')); ?>
</div>

<h3>バックナンバー</h3>

<ul id="Backnumber">
<?php
$start = 2000;
$end = date("Y");
for ($i = $end; $i >= $start; $i--) {
?>
	<li><?php $this->BcBaser->link($i . '年', 'javascript:viod()', array('class' => 'linkBackNumber', 'year' => $i)); ?></li>
<?php
}
?>
</ul>

謝辞

• http://basercms.net
• http://doc.basercms.net/
• http://cakephp.jp/
• http://www.materializing.net/