仕入れ・販売管理導入手順書 WordPress版

本書ではWordPress版仕入れ・販売管理テーマの導入に必要な環境構築からテーマの有効化・初期設定までの手順を説明します。

1. システム要件

項目	要件
WordPress	6.0 以上
PHP	7.4 以上（8.x 推奨）
データベース	MySQL 5.7 以上 / MariaDB 10.3 以上
PHP拡張	pdo_mysql, mbstring, gd, zip
対応ブラウザ	Chrome / Edge / Firefox（最新版）

PHP拡張モジュールの用途

拡張	用途
pdo_mysql	WordPress・業務テーブルのDB接続
mbstring	日本語マルチバイト文字処理
gd	商品画像のリサイズ処理
zip	バックアップ一括ZIPダウンロード

2. テーマファイル構成

sales-management/ ... テーマフォルダ ├── style.css ... テーマ識別ヘッダー ├── functions.php ... テーマ初期化・AJAX登録 ├── header.php ... 共通ヘッダー（ナビ・フラッシュメッセージ） ├── footer.php ... 共通フッター ├── front-page.php ... ダッシュボード表示 ├── index.php ... フォールバック ├── 404.php ... 404ページ ├── screenshot.png ... テーマサムネイル ├── composer.json ... Composer設定（mpdf） │ ├── inc/ ... 共通ライブラリ │ ├── class-database.php ... $wpdbラッパー（PDO互換API） │ ├── helpers.php ... ユーティリティ関数 │ ├── flash-messages.php ... フラッシュメッセージ（WPトランジェント） │ ├── auth.php ... 認証ラッパー（WP認証使用） │ ├── image-upload.php ... 画像アップロード・リサイズ │ ├── pdf-generator.php ... PDF出力ヘルパー │ ├── setup.php ... ★ テーマセットアップ・DB自動作成 │ └── navigation.php ... カスタムナビゲーション │ ├── page-templates/ │ └── page-app.php ... ★ モジュールルーター（テンプレート） │ ├── modules/ ... 各業務モジュール │ ├── dashboard/ ... ダッシュボード │ ├── suppliers/ ... 取引先管理 │ ├── products/ ... 商品管理 │ ├── purchases/ ... 仕入処理 │ ├── sales/ ... 販売処理 │ ├── reports/ ... レポート（月次・年次・PDF） │ ├── backup/ ... CSVバックアップ │ └── fiscal/ ... 年度切替 │ └── assets/ ├── css/ │ └── app.css ... スタイルシート └── js/ ├── app.js ... 共通JavaScript └── ajax-handler.js ... AJAX商品取得

3. ローカル環境での導入（XAMPP）

3.1 WordPressのインストール

XAMPPをインストール・起動
公式サイト（https://www.apachefriends.org/）からダウンロードし、Apache と MySQL を起動します。

データベースを作成
http://localhost/phpmyadmin/ にアクセスし、データベースを作成します。

-- phpMyAdmin の SQL タブで実行
CREATE DATABASE sales_management DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

WordPressをダウンロード
WordPress公式サイト（https://ja.wordpress.org/）から最新版をダウンロードします。

WordPressを配置
ダウンロードしたファイルをXAMPPのドキュメントルートに展開します。

例: 以下のフォルダにWordPressファイルを配置
C:\xampp\htdocs\marutomi\

WordPressインストールウィザード
ブラウザで http://localhost/marutomi/ にアクセスし、インストールウィザードに従います。

項目	設定値
データベース名	`sales_management`
ユーザー名	`root`
パスワード	（空欄）
データベースホスト	`localhost`
テーブル接頭辞	`wp_`（デフォルトのまま）

サイト情報を入力
サイトのタイトル、管理者ユーザー名、パスワード、メールアドレスを設定し、「WordPressをインストール」をクリックします。

データベース共有：業務テーブル（suppliers, products 等）は WordPress と同じデータベースに作成されます。WordPressテーブルは wp_ プレフィックス付き、業務テーブルはプレフィックスなしなので衝突しません。

3.2 テーマファイルの配置

テーマフォルダをWordPressの themes ディレクトリにコピーします。

コピー先:
C:\xampp\htdocs\marutomi\wp-content\themes\sales-management\

テーマフォルダ内のファイル構成を確認します。

以下のファイルが存在すること:
sales-management\style.css
sales-management\functions.php
sales-management\front-page.php
sales-management\page-templates\page-app.php
sales-management\modules\  (各モジュール)
sales-management\assets\   (CSS/JS)
sales-management\inc\      (ライブラリ)

フォルダ名について：テーマフォルダ名は任意ですが、sales-management を推奨します。

3.3 PDF出力ライブラリのインストール（任意）

レポートのPDF出力機能を使用する場合は、テーマフォルダ内でComposerを実行します。

コマンドプロンプトでテーマフォルダに移動します。

cd C:\xampp\htdocs\marutomi\wp-content\themes\sales-management

Composerでmpdfをインストールします。

composer install

vendor/ フォルダが作成され、mpdfライブラリがインストールされます。

mpdf用の一時ディレクトリを作成します。

mkdir tmp\mpdf

Composerがインストールされていない場合は、公式サイトからインストールしてください。PDF出力機能を使用しない場合、この手順はスキップできます。

3.4 テーマの有効化

WordPress管理画面（http://localhost/marutomi/wp-admin/）にログインします。

左メニューの「外観」→「テーマ」をクリックします。

「仕入れ・販売管理」テーマの「有効化」をクリックします。

自動処理：テーマ有効化時に、業務テーブル（suppliers, products, purchases, sales）が自動的に作成されます。phpMyAdminでの手動SQL実行は不要です。

テーマが一覧に表示されない場合は、フォルダの配置場所と style.css の存在を確認してください。

3.5 固定ページの作成

仕入れ・販売管理の各機能にアクセスするための固定ページを作成します。

A. 「app」ページの作成（必須）

WordPress管理画面の「固定ページ」→「新規固定ページを追加」をクリックします。

以下の内容で作成します。

項目	設定値
タイトル	`app`
スラッグ（パーマリンク）	`app`
テンプレート	仕入れ・販売管理
本文	（空欄のまま）

「公開」をクリックします。

重要：テンプレートの設定を忘れないでください。右サイドバーの「テンプレート」欄で「仕入れ・販売管理」を選択します。ブロックエディタの場合は、投稿設定パネル内にあります。

B. 「ホーム」ページの作成（必須）

もう1つ固定ページを作成します。

項目	設定値
タイトル	`ホーム`
スラッグ	（自動：`home` 等）
テンプレート	デフォルトテンプレート（変更不要）
本文	（空欄のまま）

「公開」をクリックします。

この「ホーム」ページはフロントページ（ダッシュボード）として使用されます。テンプレートは front-page.php が自動的に適用されます。

3.6 フロントページの設定

WordPress管理画面の「設定」→「表示設定」をクリックします。

「ホームページの表示」を「固定ページ」に変更します。

「ホームページ」のドロップダウンで、先ほど作成した「ホーム」を選択します。

「変更を保存」をクリックします。

この設定は必須です。この設定を行わないと、サイトトップにダッシュボードが表示されず、ログイン後に「ページが見つかりません」エラーが発生する原因となります。

3.7 動作確認

ブラウザで http://localhost/marutomi/ にアクセスします。

WordPressのログイン画面にリダイレクトされます。

WordPress管理者アカウントでログインします。

ダッシュボード（ホーム画面）が表示されれば導入完了です。

確認項目

確認項目	操作	期待結果
ログイン	サイトURLにアクセス	ログイン画面 → ログイン後ダッシュボード表示
取引先登録	取引先管理 → 新規登録	登録成功、一覧に表示される
商品登録	商品管理 → 新規登録（写真付き）	登録成功、写真が表示される
仕入登録	仕入処理 → 新規登録	金額が自動計算され登録される
売上登録	販売処理 → 新規登録	金額が自動計算され登録される
レポート	月次一覧 / 年次一覧を表示	集計結果が正しく表示される
PDF出力	月次/年次レポートの「PDF出力」	PDFファイルがダウンロードされる
バックアップ	設定 → バックアップ → CSVダウンロード	CSVファイルがダウンロードされる
ログアウト	設定 → ログアウト	ログイン画面に戻る

すべての項目が正常に動作すれば、ローカル環境での導入は完了です。

4. 本番環境での導入（Xserver）

4.1 WordPressのインストール

Xserverでは「WordPress簡単インストール」機能を利用できます。

Xserverのサーバーパネルにログインします。

「WordPress簡単インストール」をクリックします。

対象ドメインを選択し、「WordPressインストール」タブをクリックします。

以下の情報を入力します。

項目	設定値
サイトURL	ドメイン名（サブディレクトリを使う場合は指定）
ブログ名	仕入れ・販売管理
ユーザー名	管理者のユーザー名
パスワード	管理者のパスワード
メールアドレス	管理者のメールアドレス

「確認画面へ進む」→「インストールする」をクリックします。

メモしてください：インストール完了画面に表示される管理画面URL・ユーザー名・パスワード・MySQLデータベース情報を控えてください。

4.2 テーマファイルのアップロード

以下のいずれかの方法でテーマファイルをアップロードします。

方法A: WordPress管理画面からアップロード（推奨）

テーマフォルダをZIPファイルに圧縮します。

sales-management.zip を作成
（sales-management/ フォルダごとZIP化）

WordPress管理画面の「外観」→「テーマ」→「新しいテーマを追加」→「テーマのアップロード」をクリックします。

ZIPファイルを選択し、「今すぐインストール」をクリックします。

方法B: FTPソフトでアップロード

FTPソフト（FileZilla等）でXserverに接続します。

テーマフォルダを以下のパスにアップロードします。

アップロード先:
/home/サーバーID/ドメイン名/public_html/wp-content/themes/sales-management/

vendor/ フォルダについて：PDF出力機能を使用する場合は、ローカルで composer install を実行後、vendor/ フォルダも含めてアップロードしてください。

4.3 PDF出力ライブラリのインストール（任意）

PDF出力機能を使用する場合、以下のいずれかの方法でmpdfライブラリを設置します。

方法A: ローカルでインストールしてアップロード（推奨）

ローカルのテーマフォルダで composer install を実行
生成された vendor/ フォルダをサーバーにアップロード

方法B: サーバー上でComposerを実行

XserverでSSH接続を有効化（サーバーパネル → SSH設定）
SSH接続し、テーマディレクトリで composer install を実行

一時ディレクトリの作成

テーマフォルダ内に tmp/mpdf/ ディレクトリを作成し、書き込み権限（755）を設定します。

FTPまたはファイルマネージャーで作成:
themes/sales-management/tmp/mpdf/   パーミッション: 755

4.4 テーマの有効化

WordPress管理画面にログインします。

「外観」→「テーマ」をクリックします。

「仕入れ・販売管理」テーマの「有効化」をクリックします。

自動処理：テーマ有効化時に業務テーブル（suppliers, products, purchases, sales）が自動作成されます。phpMyAdminでの手動SQL実行は不要です。

4.5 固定ページの作成

ローカル環境と同じ手順で2つの固定ページを作成します。

A. 「app」ページ（必須）

項目	設定値
タイトル	`app`
スラッグ	`app`
テンプレート	仕入れ・販売管理

B. 「ホーム」ページ（必須）

項目	設定値
タイトル	`ホーム`
テンプレート	デフォルトテンプレート

重要：「app」ページのテンプレートに「仕入れ・販売管理」を選択することを忘れないでください。

4.6 フロントページの設定

WordPress管理画面の「設定」→「表示設定」をクリックします。

「ホームページの表示」を「固定ページ」に変更します。

「ホームページ」で「ホーム」を選択します。

「変更を保存」をクリックします。

この設定は必須です。この設定を行わないと、ログイン後に「ページが見つかりません」エラーが発生します。

4.7 セキュリティ設定

A. 管理者パスワードの確認

WordPressインストール時に設定したパスワードが十分に強力であることを確認してください。

B. WordPressのセキュリティ

WordPress・プラグインを常に最新版に更新してください
不要なプラグイン・テーマは削除してください
ログイン試行回数制限プラグイン（例: Limit Login Attempts）の導入を推奨します

C. SSL設定

Xserverの無料SSLを有効化し、サイト全体をHTTPSで運用してください。

サーバーパネル →「SSL設定」→ 対象ドメインを選択 →「独自SSL設定追加」
WordPress管理画面 →「設定」→「一般」で、サイトURLを https:// に変更

4.8 動作確認

以下の項目を確認し、正常に動作することを確かめてください。

確認項目	操作	期待結果
ログイン	サイトURLにアクセス	ログイン画面 → ログイン後ダッシュボード表示
取引先登録	取引先管理 → 新規登録	登録成功、一覧に表示される
商品登録	商品管理 → 新規登録（写真付き）	登録成功、写真が表示される
仕入登録	仕入処理 → 新規登録	金額が自動計算され登録される
売上登録	販売処理 → 新規登録	金額が自動計算され登録される
商品連動	仕入/売上で取引先を選択	商品リストが自動更新される
レポート	月次一覧 / 年次一覧を表示	集計結果が正しく表示される
PDF出力	月次/年次レポートの「PDF出力」	PDFファイルがダウンロードされる
バックアップ	設定 → バックアップ → CSVダウンロード	CSVファイルがダウンロードされる
年度切替	設定 → 年度切替（確認のみ）	年度切替画面が正しく表示される
ログアウト	設定 → ログアウト	ログイン画面に戻る

5. 既存データの移行

旧版（非WordPress版）からデータを移行する場合の手順です。

方法A: 同一データベースを使用（推奨）

旧版と同じデータベースにWordPressをインストールした場合、既存の業務テーブル（suppliers, products, purchases, sales）がそのまま使用されます。

WordPressインストール時に、旧版と同じデータベース名を指定します
テーマを有効化します（既存テーブルがある場合、CREATE TABLE IF NOT EXISTS により上書きされません）
既存データがそのまま仕入れ・販売管理に表示されます

注意：旧版の users テーブルは WordPress版では使用されません。WordPress のユーザー管理に移行してください。

方法B: CSVで移行

旧版のバックアップ機能で全テーブルのCSVをダウンロードします
新環境のphpMyAdminでCSVをインポートします

インポート順序：外部キー制約があるため、以下の順序でインポートしてください。
suppliers → products → purchases → sales

商品画像の移行

旧版の保存先	WordPress版の保存先
`uploads/products/`	`wp-content/uploads/sales-management/products/`

旧版の uploads/products/ 内の画像ファイルを、WordPress版の保存先にコピーしてください。

6. トラブルシューティング

ログイン後に「ページが見つかりません」と表示される

原因	対処法
フロントページ設定が未完了	「設定」→「表示設定」で「固定ページ」を選択し、ホームページに「ホーム」を設定してください（手順3.6 参照）
「ホーム」固定ページが未作成	固定ページ「ホーム」を作成してください（手順3.5 参照）
パーマリンク設定の問題	「設定」→「パーマリンク」で「変更を保存」を一度クリックしてください（.htaccess の再生成）

取引先・商品などの画面が表示されない（404）

原因	対処法
「app」固定ページが未作成	スラッグ `app` の固定ページを作成し、テンプレート「仕入れ・販売管理」を選択してください（手順3.5 参照）
テンプレートが未設定	「app」ページの編集画面で、テンプレートに「仕入れ・販売管理」を選択し直してください

テーマ有効化後にテーブルが作成されない

原因	対処法
テーマの再有効化が必要	別のテーマに切り替え → 再度「仕入れ・販売管理」を有効化してください
データベース権限不足	WordPressのDBユーザーにCREATE TABLE権限があることを確認してください

商品画像がアップロードできない

原因	対処法
ディレクトリ権限	`wp-content/uploads/` に書き込み権限（755）があることを確認してください
PHPのファイルサイズ制限	php.ini の `upload_max_filesize` と `post_max_size` を確認してください

PDF出力でエラーが出る

原因	対処法
vendor/ フォルダ未設置	テーマフォルダ内で `composer install` を実行、または `vendor/` フォルダをアップロード
tmp/mpdf/ の権限不足	テーマフォルダ内に `tmp/mpdf/` を作成し、書き込み権限（755）を設定
mbstring 拡張が無効	サーバーのPHP設定で mbstring を有効にしてください

AJAX商品取得が動作しない（取引先選択後に商品リストが表示されない）

原因	対処法
JavaScriptエラー	ブラウザの開発者ツール（F12）でコンソールエラーを確認してください
WordPress AJAX URL の問題	テーマの `functions.php` と `inc/setup.php` が正しく読み込まれているか確認してください

CSVバックアップでZIPがダウンロードできない

原因	対処法
PHP zip 拡張が無効	サーバーのPHP設定で `zip` 拡張を有効にしてください

7. 導入チェックリスト

ローカル環境

XAMPP（Apache / MySQL）が起動している
データベースを作成した
WordPressをインストールし、管理画面にログインできる
テーマフォルダを wp-content/themes/ に配置した
「仕入れ・販売管理」テーマを有効化した
phpMyAdminで4つの業務テーブルが作成されたことを確認した
固定ページ「app」を作成し、テンプレート「仕入れ・販売管理」を設定した
固定ページ「ホーム」を作成した
表示設定でフロントページに「ホーム」を設定した
サイトURLにアクセスしてダッシュボードが表示されることを確認した
取引先登録 → 商品登録 → 仕入登録 → 売上登録が正常に動作する
（任意）composer install でmpdfをインストールした
（任意）tmp/mpdf/ ディレクトリを作成した
（任意）PDF出力が正常に動作することを確認した

本番環境（Xserver）

Xserverの「WordPress簡単インストール」でWordPressをインストールした
WordPress管理画面にログインできることを確認した
テーマファイルをアップロードした（ZIP or FTP）
「仕入れ・販売管理」テーマを有効化した
業務テーブル（suppliers, products, purchases, sales）が作成されたことを確認した
固定ページ「app」を作成し、テンプレート「仕入れ・販売管理」を設定した
固定ページ「ホーム」を作成した
表示設定でフロントページに「ホーム」を設定した
サイトURLにアクセスしてダッシュボードが表示されることを確認した
取引先・商品の登録、仕入・売上の登録が正常に動作することを確認した
バックアップ（CSV / ZIP）が正常にダウンロードできることを確認した
SSL（HTTPS）が有効になっている
管理者パスワードが十分に強力であることを確認した
（任意）vendor/ フォルダをアップロードした
（任意）tmp/mpdf/ ディレクトリを作成し、書き込み権限を設定した
（任意）レポートのPDF出力が正常に動作することを確認した
（移行時）旧版からデータを移行した場合、データが正しく表示されることを確認した
（移行時）商品画像を新しい保存先にコピーした

仕入れ・販売管理（WordPress版）導入手順書 — v1.0

仕入れ・販売管理 導入手順書 WordPress版

目次