PHPackages                             pickles2/px2-sitemapexcel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. pickles2/px2-sitemapexcel

ActiveLibrary[Utility & Helpers](/categories/utility)

pickles2/px2-sitemapexcel
=========================

Pickles 2 に、サイトマップをグラフィカルなエクセル形式(xlsx)で編集できる機能を追加します。

2.4.0(9mo ago)011.0k20MITPHPPHP >=7.3

Since Dec 24Pushed 9mo ago2 watchersCompare

[ Source](https://github.com/pickles2/px2-sitemapexcel)[ Packagist](https://packagist.org/packages/pickles2/px2-sitemapexcel)[ RSS](/packages/pickles2-px2-sitemapexcel/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (27)Used By (20)

pickles2/px2-sitemapexcel
=========================

[](#pickles2px2-sitemapexcel)

    Linux Windows     master  [![](https://camo.githubusercontent.com/218af9271c21a0e678e346f464948e1b08141f96782a56ddde0d5cd8e8fce1fa/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f7069636b6c6573322f7078322d736974656d6170657863656c2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/pickles2/px2-sitemapexcel)   [![](https://camo.githubusercontent.com/264cba89547568d8610dcb4f5634e79c73d72d9bf6d01cfe699993d06a7cf237/68747470733a2f2f63692e6170707665796f722e636f6d2f6170692f70726f6a656374732f7374617475732f65707265393167386971666a6e6930382f6272616e63682f6d61737465723f7376673d74727565)](https://ci.appveyor.com/project/tomk79/px2-sitemapexcel)    develop  [![](https://camo.githubusercontent.com/a36e997bde031a3f2f438cb7f4f0abd8de82a42163d5da72694028acd0369dd0/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f7069636b6c6573322f7078322d736974656d6170657863656c2e7376673f6272616e63683d646576656c6f70)](https://travis-ci.org/pickles2/px2-sitemapexcel)   [![](https://camo.githubusercontent.com/b8cc08dccc2dfd072b1b71f13456461e432bbfb822c2f224a2b41d1ddbf53710/68747470733a2f2f63692e6170707665796f722e636f6d2f6170692f70726f6a656374732f7374617475732f65707265393167386971666a6e6930382f6272616e63682f646576656c6f703f7376673d74727565)](https://ci.appveyor.com/project/tomk79/px2-sitemapexcel)   *pickles2/px2-sitemapexcel* は、[Pickles 2](https://pickles2.pxt.jp/) のサイトマップを、 Excel 形式 (`*.xlsx`) で編集できるようにするプラグインです。

本来の Pickles 2 のサイトマップは、CSV形式で記述されます。 CSVはもっとも単純で基本的なデータ形式の1つで、コンピューターが処理するには扱いやすいフォーマットですが、人間が編集するには不便なこともありました。 このプラグインを導入することで、より直感的でグラフィカルな Excel 形式 (`*.xlsx`) で編集することができるようになります。

- Excel 形式 (`*.xlsx`)のサイトマップファイルを直接読み込むことができるようになります。
    - `*.xlsx` を更新すると、次のアクセス時に自動的に読み込まれ、 `*.csv` の内容が上書きされます。
    - `*.csv` を更新した場合は、逆に `*.xlsx` が上書きされます。タイムスタンプが新しい方を正として、古い方が上書きされます。
    - この挙動は、 `master_format` オプション および `files_master_format` オプションで変更することができます。
- ページの階層構造(`logical_path`)を、視覚的な階層構造で表現できます。
- エクセルの 色付きセル や テキスト装飾 などの編集機能を使い、美しい表をアレンジできます。
- セル値に Excel の計算式を使うことができます。
- `*.xlsx` の `A1` のセルに、サイトマップの設定が記述されています。
    - 設定例 : `row_definition=8&row_data_start=9&skip_empty_col=20&version=2.0.5`
    - *row\_definition* : 定義行番号
    - *row\_data\_start* : データ行の開始行番号
    - *skip\_empty\_col* : 定義行に値のない列がある場合、その先を読み込む列数
    - *version* : この `*.xlsx` ファイルを生成した *pickles2/px2-sitemapexcel* のバージョン番号
- `A` 列に、文字列 `EndOfData` を見つけたら、それより下の行はスキャンされません。コメント欄を追加したり、ページ数のカウンターを設置するなど、自由に使えます。
- 拡張カラム `**delete_flg` に `1` をセットすると、CSVに出力されなくなります。
- 1枚目のシートを使用します。2枚目以降のシートは読み取りません。

Excel ファイルの操作には、 [phpoffice/phpexcel](https://github.com/PHPOffice/PHPExcel) を利用しています。

※旧名 pickles-sitemap-excel-2 から px2-sitemapexcel へ名称変更されました。

導入手順 - Setup
------------

[](#導入手順---setup)

### 1. composer.json に pickles2/px2-sitemapexcel を追加

[](#1-composerjson-に-pickles2px2-sitemapexcel-を追加)

require の項目に、"pickles2/px2-sitemapexcel" を追加します。

```
$ composer require pickles2/px2-sitemapexcel;

```

### 2. config.php に、機能を追加

[](#2-configphp-に機能を追加)

設定ファイル config.php (通常は `./px-files/config.php`) を編集します。 `before_sitemap` のどこか(例では最後)に、`tomk79\pickles2\sitemap_excel\pickles_sitemap_excel::exec` を追加します。

```