PxFW 1.x で、エクセルファイル(*.xlsx)でサイトマップを管理できるようにするプラグイン。
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_docs
libs/PHPExcel
plugins/sitemapExcel
.gitignore
README.md

README.md

sitemapExcel (PxPlugin)

sitemapExcelプラグインは、Pickles Framework(PxFW)のサイトマップCSVを、見やすい Microsoft Excel 形式で、より直感的な形式で編集できるようにします。

インストール方法 - Setup

  1. Pickles Framework(PxFW) をダウンロードして、セットアップする。
  2. ディレクトリ plugins/sitemapExcel を、 PxFW の _PX/plugins ディレクトリにアップロードする。
  3. ディレクトリ libs/PHPExcel を、 PxFW の _PX/libs ディレクトリにアップロードする。
  4. PxFW の _PX/sitemaps ディレクトリ、 およびすべてのサブディレクトリとファイルに、 ウェブサーバーから書き込み可能なパーミッションを設定する。

エクセルファイルの容量が大きい場合に、インポート時にメモリが足りずに異常終了することがあります。この場合、.htaccessphp_value memory_limit -1 を有効にするなどして、使用可能なメモリを増やすことで解決されるかも知れません。

使い方 - Usage

  1. ブラウザで、URLにPX Command ?PX=plugins.sitemapExcel をつけてアクセスする。
  2. インポートボタンをクリックする。
  3. エクセルファイルをドラッグ&ドロップする、またはファイル選択してアップロードする。

エクセルファイルの作り方、形式

  • 一番左上のセル A1 に次のような形式で設定を記入します。
    例:row_definition=8&row_data_start=9&skip_empty_col=20&version=0.5.0
    • row_definition : 定義行の行番号 (default: 8)
    • row_data_start : データ領域開始行の行番号 (default: 9)
    • skip_empty_col : データ行に空白列があった場合に、より右を検索する上限列数 (default: 20)
    • version : そのエクセルを出力したsitemapExcelのバージョン番号
  • row_definition にセットした行が定義行になります。定義行に、セルの物理名を記入してください。通常は、PxFW の標準的なサイトマップの定義(参照: サイトマップCSVの定義)が入りますが、好きな列名を追加で定義したり、列の順番を入れ替えることができます。(ここで独自に定義した列には、PxFWの $px->site()->get_page_info() を通じてアクセスできます)
  • row_data_start に定義した行以降に、実際のサイトマップを記入してください。
    • title列は、複数列を使って、段のように階層を表現することができます。このとき、階層の深さは自由に増やせますが。その分のすべての行の定義行をセル連結してください。
    • title列、path列の両方が空白の行を見つけると、それ以降の行は無視されます。
    • または、A列に、固定文字列 EndOfData を検出すると、それ以降のセルを無視するようになります。
  • sitemapExcel は、一番左のシートしか参照しません。2枚目以降のシートは無視されます。

エクスポート機能でダウンロードできるファイルを参考にすると、理解が早まります。

システム要件 - Requirement

PxFW および PHPExcel の要件を参照。

  • Pickles Framework requirement
    • Linux系サーバ または Windowsサーバ
    • Apache1.3以降
      • mod_rewrite が利用可能であること
      • .htaccess が利用可能であること
    • PHP5.3以上
      • mb_string が有効に設定されていること
      • safe_mode が無効に設定されていること
  • PHPExcel requirement
    • PHP version 5.2.0 or higher
    • PHP extension php_zip enabled
    • PHP extension php_xml enabled
    • PHP extension php_gd2 enabled (if not compiled in)

Pickles Framework(PxFW) について

詳しくは下記のウェブサイトを参照してください。

ライセンス - License

MIT License

作者 - Author