inc​/xupdate

X-updateとは？

アップデータモジュール「X-update」（えっくす・あっぷでーと）は、XCL (Xoops Cube Legacy) 2.2 以降で動作し、モジュールやテーマのインストールやアップデートをFTPクライアントを使わずに迅速に行うことが可能になる、ユーティリティ系モジュールです。

何ができるの？

• FTPクライアントソフトにノータッチで、対応モジュールやテーマをインストールできます。
• 対応モジュールやテーマの最新版を、xupdateの管理画面操作だけで各公開サーバーからダウンロード取得し、解凍・展開・アップロードまでやってくれますから、その後で通常のモジュールインストール操作を行うだけです。
• モジュールだけではなく、テーマもストアサイトからダウンロード取得～アップロードまでやってくれます。

動作要件

xupdateを使うためには、以下の環境が必須または推奨となります。

• PHP 5.2.0以上 (必須)
  • cURLエクステンション (必須)
  • zip 拡張関数：--enable-zipでphpがコンパイルされている (推奨)
• MySQL 5.0 以上 (必須)
• Xoops Cube legacy 2.2.0 以上

対象モジュール・テーマ

使い方

ダウンロード

GitHubのXoopsX配布リポジトリ群の中にあり、以下のURLで最新のスナップショットソースをダウンロードできます。 最終的に、Xoops X (ten)　パッケージに同梱され、2ndインストーラで導入推奨モジュールとなる予定です。
https://github.com/XoopsX/xupdate/downloads
（現時点ではアルファ版のため動作が不安定です。また、今後の改編で再インストールが必要になる場合があります。）

展開とサーバーへのアップロード

zipまたはtar.gzどちらかお好みのアーカイブでダウンロードし、解凍・展開ののち、d3モジュールなど複製対応モジュールと同様に、　html配下（htmlフォルダは含まず）を、xoopsのxoops_rooth_pathに設定されたサーバー上のフォルダ内に。xoops_trust_path配下を同じくxoops_trust_path内にアップロードします。

インストール

xupdateのインストールは、通常のxoops cubeモジュールのインストールと同様です。

一般設定

• 圧縮ファイルダウンロード・展開用フォルダ
  アーカイブをダウンロードして展開するために使用するフォルダ。(xoops_trust_path)配下のディレクトリを指定、最初と最後の"/"（スラッシュ）は含めません。通常は、uploads/xupdate　のままでご使用ください。
  このフォルダには、707,777 などの書き込み権限を与えてください。

• 使用するFTPライブラリ
  サーバーにファイル群をアップロードする際に使用するFTPライブラリの選択。カスタムFTP（標準）を選択して問題が解決できない場合、
  PHP_FTP（FTP over SSL用）や、カスタムSSH_FTPをお試しください。
  • カスタムFTP（標準）
    PHPにFTP関数が実装されていない場合は、まずはこのカスタムFTPを選択します。
  • PHP_FTP（FTPS用）
    PHPにFTP関数が実装されている場合は、こちらも選択できます。　サーバーがFTPSでの転送をサポートする場合は、これを選択して、次項でSSL(FTPS)を設定します。
  • カスタムSSH_FTP
    サーバーがSSHの使用をサポートしている場合、標準のカスタムFTPよりもこちらの方が高速に動作する場合があります。

• SSL(FTPS)を使用する
  前項で「PHP_FTP（FTPS用）」を指定した場合に、SSL(FTPS)が使用可能です。

• FTPログインID／FTPログインパスワード
  ご使用のサーバーの、FTPログインIDとパスワードを入力します。

• デバグ出力を表示する
  問題が解決しない場合は、ここを「はい」とすることで、追加デバグ情報が表示されます。
• テーマURL
  CMS Theme Finder のURLで、通常は変更不要です。

動作チェック

展開フォルダの権限設定が不適切だったり、FTPログイン設定が間違っていると、上のように赤字で表示されます。　下のように緑色表示になると正常ですので、設定を見直してください。

モジュール

• 「モジュール」タブを選択すると、モジュール一覧表示になります。
  
• 「操作」のアイコンをクリックすると、インストール・またはアップデート画面に移ります。
  
• 「インストール」をクリックすると、アーカイブのダウンロード・展開・サーバーへのFTPでの配置が行われます。
  
• 「インストール」をクリックして、通常のモジュールインストールに進みます。
  

ディレクトリ名の変更

d3モジュールなど、複製対応モジュールはモジュール名（ディレクトリ名）が変更可能です。

• まず、「モジュール名」を編集し、「モジュール名編集」ボタンで送信
  
• 確認画面で確認し、「アップデート」
  
• 編集が保存されるので、インストールに進みます。　元のモジュール名の行が追加されていますので、同様に追加インストールやモジュール名変更操作が可能です。
  

• 元のモジュール名のままインストールした場合には、　その行のモジュール名を同様の手順で編集・アップデートすることで、　編集後の行と元のモジュール名の行になってくれます。

テーマ

テーマも、モジュールと同様の手順でインストールが可能です。　テーマ名の変更・複製はできません。

テーマファインダ

CMS Theme Finderに登録されているテーマをダウンロード・インストールできます。