既存 HTML からのインポート

※ この機能はエンタープライズ版以上のライセンスをご購入の場合のみご利用可能です

既存の HTML や XML 等のファイルから、記事/ウェブページへインポートすることができるため、サイトリニューアル等の際、過去のコンテンツ資産を有効に再利用できます。

また、指定したURLからコンテンツを取得してインポートを行うことができます。これにより、WordPress などの静的ファイルを持たない動的 CMS からの移行が容易になります。

情報を取り出すためのオプションとして、正規表現だけでなく、XPath やCSS パスを指定することができるので、ブラウザの開発者ツール等で対象を確認しながら設定できます。

Perl モジュール HTML::TreeBuilder::XPath、HTML::Selector::XPath が必要です。

インポートの設定

ファイルからのインポートの場合

事前準備

ワークスペース/スペースのサイト・パス以下の任意の場所に、取込み対象のファイル(HTML 等)をあらかじめ設置しておきます。HTML 内で利用されている画像等をあわせて設置しておくことでインポートと同時にアイテムとして登録することができます。

インポートの実行

ワークスペース/スペースで [インポート/エクスポート] - [記事のインポート] を選択し、 [インポート元] で「既存の HTML ページ」を選択し、インポートオプションのインポート元「ファイル」を選択します。

<mt:folderPath>/<mt:pagebasename>.html

URL を指定したインポートの場合

制限事項

会員サイトなどログインが必要なサイトのインポートは行えません。

インポートの実行

ワークスペース/スペースで [インポート/エクスポート] - [記事のインポート] を選択し、 インポート元「既存の HTML ページ」を選択し、インポートオプションのインポート元「URL」を選択します。

<mt:folderPath>/<mt:pagebasename>.html

フィールドのオプション

その他のオプション

環境変数

アイテムの同時取り込み

記事/ウェブページのインポートと同時にページに含まれる画像等を同時に「アイテム」として取り込むことができます。

インポートするワークスペース/スペースの PowerCMS 設定の「カスタムサイドバー「アセット」設定」で、「アイテムのパスを絶対パスに変換(常に変換)」「絶対パス変換時にアイテムへ登録する」の2つにチェックが入っている必要があります。

プラグインによる拡張

記事/ウェブページのインポート直後に発行されるコールバックに呼応して動作するプラグインを作成することで、カスタムフィールドへのデータ投入等を同時に行うことができます。

以下の例は HTML から本文を抽出する Perl モジュール HTML::ExtractContent を利用してウェブページの本文に抽出したテキストをインポートするサンプルです。

package MT::Plugin::ExtractContent;

use strict;
use MT;
use MT::Plugin;
use base qw( MT::Plugin );

our $plugin = __PACKAGE__->new({
  name => 'ExtractContent',
});

MT->add_plugin( $plugin );
sub init_registry {    my $plugin = shift;
  $plugin->registry({
    callbacks => {
      'cms_post_import.page' => \&_cms_post_import,
    },
  });
}

sub _cms_post_import {
  my ( $cb, $app, $entry, $path, $data ) = @_;
  require HTML::ExtractContent;
  my $extractor = HTML::ExtractContent->new;
  $extractor->extract( $data );
  my $text = $extractor->as_html;
  $entry->text( $text );
  $entry->save or die $entry->errstr;
}

1;