WordPress 店舗検索プラグイン
DocoDoco Store Locator
ユーザ向けマニュアル
株式会社Geolocation Technology

第2版 2024/03/06

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

⽬次
概要

3

利⽤⼿順

4

機能⼀覧

9

各機能の詳細

10

店舗⼀覧

10

店舗登録

11

表⽰設定

13

導⼊⽅法

16

テンプレートについて

17

店舗⼀括インポート・エクスポート

20

Q&A

26

動作環境

31

β版からのアップデートガイド

32

お問い合わせ36

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

2

概要「DocoDoco Store Locator」は店舗の紹介ページを簡単に作ることができるプラグインです。
シンプルな使い⽅
プラグイン専⽤のショートコードを固定ページなどに貼り付けるだけで、店舗の⼀覧ページ、詳細ページを作成できます。

⽤途に合わせたデザイン
表⽰する店舗ページのテンプレートは複数種類から選択できます。
インポート機能
店舗情報をCSVファイルで登録・更新できます。

どこどこJP 連携ができる
どこどこJP 連携を利⽤するとアクセスユーザの現在地に近い店舗を表⽰できます。
※どこどこJP は、アクセスユーザのIPアドレスからユーザの地域、組織、回線などの情報を取得できるAPIサービスです。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

3

利⽤⼿順
1. プラグインのインストール「WordPress管理画⾯メニュー > プラグイン」より、「DocoDoco Store Locator」をインストールして、有効化します。

プラグインを有効化後、メニューに「店舗管理」が追加されます。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

4

利⽤⼿順
2. 店舗登録「メニュー > 店舗管理 > 店舗登録」より、公開サイトで表⽰する店舗を新規登録します。
※初期データとしてサンプルの店舗データが登録されてますので、不要であれば削除してください。（削除⽅法は「P.10」を参照）

画⾯の使⽤⽅法は、「p.11」を参照

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

5

利⽤⼿順
3. 表⽰設定「メニュー > 店舗管理 > 表⽰設定」より、公開サイトで表⽰するテンプレートの設定を⾏います。

画⾯の使⽤⽅法は、「p.13」を参照

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

6

利⽤⼿順
4. ショートコードの設置
テンプレートを表⽰したい固定ページなどにショートコードを設置します。
ショートコードは「メニュー > 店舗管理 > 導⼊⽅法」より確認できます。
※詳細ページのショートコードは⼀覧ページと別のページに設置してください。

カスタムHTMLよりショートコードを設置してください。

[docosl_storelist]

詳細ページを利⽤しない場合は不要です。

[docosl_storedetail]

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

7

利⽤⼿順
5. ページの表⽰確認
設定が正しい場合は、ショートコードを設置したページに以下のようなテンプレートが表⽰されます。
※テンプレートが表⽰されない場合は、再度「利⽤⼿順」や「Q&A」を参照して、設定に不⾜や間違いがないことをご確認ください。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

8

機能⼀覧
機能名概要

詳細参照ページ

登録されている店舗を⼀覧で確認できます。また、CSVによる店舗の⼀括登録や店舗の⼀括削除、公開・⾮公開の編集ができます。

P10〜

店舗登録

新規店舗の登録と登録されている店舗情報の更新ができます。

P11〜

表⽰設定

公開サイト側で使⽤するテンプレートについての表⽰設定ができます。

P13〜

導⼊⽅法

公開サイト側にテンプレートを表⽰するためのショートコードを確認することができます。

P16〜

店舗⼀覧

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

9

店舗⼀覧
チェックをONにした店舗の、削除もしくは公開状態の更新を⼀括編集できます。

店舗情報を更新せず、ZIPファイルのエラーチェック、変更内容の表⽰のみを実⾏します。

ZIPファイルで店舗を⼀括登録することができます。

登録されている店舗情報をZIPファイルでエクスポートします。

クリックすると店舗を新規登録する画⾯に遷移します。

クリックするとクリックした店舗の編集画⾯に遷移します。

登録されている店舗が⼀覧で表⽰されます。

※ZIPインポート・エクスポートの詳細は「P.20」を参照してください。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

10

店舗登録

他の店舗と重複する名前は登録できません。

どこどこJP 連携を使⽤しない場合の店舗⼀覧の表⽰順序を指定できます。
※未⼊⼒で登録した場合は最後尾の値(登録済み店舗の中の最⼤値+1)になります。

アップロードできる画像:
形式: JPEG, PNG
サイズ: 1MB 以下

店舗の位置を緯度・経度で⼊⼒します。
※緯度・経度の取得⽅法は次⾴を参照してください。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

11

店舗登録
■緯度・経度の取得⽅法
1. Google Mapを開く
2. 緯度・経度を知りたい店舗を検索
3. ヒットした検索位置にカーソルを当てて右クリック
4. 緯度・経度を取得表⽰された緯度・経度をそれぞれプラグインで登録してください。
※「緯度, 経度」の順で表⽰されます。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

12

表⽰設定
■全体設定

「使う」を選択した場合、マップ︓アクセスユーザの現在地から近い店舗をマップの枠に表⽰します。
店舗リスト︓アクセスユーザの現在から近い店舗順に並び替えされます。

どこどこJPを使った店舗⼀覧の表⽰切替を「使う」にした場合は⼊⼒必須です。
どこどこJP APIキーをお持ちでない⽅はこちらから発⾏してください。

地図設定を「使う」にした場合は⼊⼒必須です。
Google Maps Platform公式ドキュメント などを参考に、APIキーを発⾏してください。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

13

表⽰設定

詳細ページを「使う」場合は必須⼊⼒です。
※ プラグイン側でURLのリンク切れはチェックしないので、設定後は必ず動作確認をしてください。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

14

表⽰設定
■個別設定

Google マップを表⽰するかを切り替えます。
どちらか⼀⽅でも Google マップを表⽰する場合はGoogle Maps API キーの⼊⼒が必要です。

⼀覧ページ・詳細ページに表⽰する情報を切り替えられます。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

15

導⼊⽅法

[docosl_storelist]

⼀覧・詳細ページのそれぞれでショートコードを設置してください。
[docosl_storedetail]

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

16

テンプレートについてテンプレートの各種設定⽅法については、「P.13」を参照してください。
■どこどこJPを利⽤する場合※下図の例は⼀覧ページの「テンプレート1」です。

サイト訪問者の現在地から近い店舗を表⽰します。
※現在地の近くに店舗がない場合は、表⽰枠内に店舗が表⽰されない場合があります。

サイト訪問者の現在地から順に店舗を表⽰します。
※店舗登録時に設定する「並び順」は適⽤されません。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

17テンプレートについて■どこどこJPを利⽤しない場合※例の下図は⼀覧ページの「テンプレート1」です。

表⽰店舗が枠内に収まるように表⽰します。

店舗登録時に設定した「並び順」の昇順で表⽰します。※「並び順」が同じ店舗がある場合は、店舗名の昇順で並び替えされます。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

18

テンプレートについて■キーワード検索
⼊⼒エリアにキーワードを⼊⼒して検索ボタンをクリックします。
マップ︓検索に⼀致した店舗のみマップ上に表⽰されます。
店舗⼀覧︓検索に⼀致した店舗のみが表⽰されます。
■現在地の取得
位置情報を許可する場合は、GPSより現在地を取得します。
位置情報を許可しない場合は、どこどこJP APIより取得します。
※現在地を取得する機能は、どこどこJPを利⽤する設定の場合のみ有効です。

■詳細ページへの遷移
店舗⼀覧の店舗名をクリックすると、詳細ページへ遷移します。
※詳細ページを使⽤しない設定にしている場合は、対象店舗に登録しているURLに遷移します。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

19

店舗⼀括インポート・エクスポート◾ 店舗⼀括インポートとは︖
ZIPファイルをアップロードすることで店舗情報を⼀括で登録・更新する機能です。
■ 店舗⼀括エクスポートとは︖
現在登録されている店舗情報をZIPファイルでダウンロードできる機能です。
エクスポートされたZIPファイルはインポート機能で使⽤できる形式です。
インポート機能を使⽤するための雛形が欲しい場合は⼀度ZIPエクスポートを実⾏してください。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

20

店舗⼀括インポート◾インポート⼿順
1. 「メニュー > 店舗管理 > 店舗⼀覧」をクリック
2. 「ZIPインポート」ボタンをクリック※「ZIPインポート（テスト実⾏）」については、「Q＆A」を参照してください。

3. ZIPファイルを選択して、インポート
INSERT︓新規追加された店舗を表します。
UPDATE︓既に存在している店舗に対して更新を⾏ったことを表します。

エラー有無を確認できます。

アップロードした店舗写真を確認できます。
変更のないファイル、使⽤されてないファイルはアップロードされません。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

21

店舗⼀括インポート◾ZIPファイルのフォーマット
【フォルダ構成】
フォルダ名、CSVファイル名は下図の通りに作成してください。
1階層⽬のフォルダ名は docosl-stores としてください。
画像ファイルを格納するフォルダとCSVファイルが格納されます。
2階層⽬のファイルです。
店舗情報が⼊⼒されたCSVファイルが格納されます。
ファイル名は store-list.csv としてください。

店舗画像は store-images フォルダの下に格納してください。

※CSVファイルの⽂字エンコードは UTF-8 にのみ対応しています。
※店舗画像のファイル名には半⾓英数字とハイフン、アンダースコアのみの使⽤をお勧めします。
Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

22

店舗⼀括インポート【CSVファイルの構成】
列名

⼊⼒値

必須

sort_order

画⾯表⽰時の並び順※どこどこJP連携を使⽤しない場合に有効◯

id

各店舗に紐づくid（重複はNG）※未⼊⼒の場合は⾃動採番されて、店舗が新規追加されます。
※正の整数のみ対応しています

name

店舗・⽀店名※同じ名前の店舗は複数登録できません

postal_code

郵便番号

address

住所

tel

電話番号

fax

FAX番号

url

URL

email

メールアドレス

open_hours

営業時間

◯

次⾴に続きます。
Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

23

店舗⼀括インポート
列名

⼊⼒値

必須

regular_holiday

定休⽇parking

駐⾞場

lat

店舗の緯度◯lng

店舗の経度◯

img_filename店舗画像のファイル名（拡張⼦も含む）
例︓store1.png

remarks

備考

admin_remarks

管理画⾯備考publish_status

1 or 2を⼊⼒します。
未⼊⼒の場合は1（⾮公開）で登録されます。

◯

1: ⾮公開2: 公開

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

24店舗⼀括エクスポート◾エクスポート⼿順
1. 「メニュー > 店舗管理 > 店舗⼀覧」をクリック
2. 「ZIPエクスポート」ボタンをクリック※ 「ZIPエクスポート」ボタンをクリックするとZIPファイル「docosl-stores.zip」がダウンロードされます。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

25

Q&A
Q. ⼀覧ページのテンプレートが表⽰されません。
A. 主な原因として考えられるのは以下の通りです。
①ショートコードを設置していない→「P.4 利⽤⼿順」を参照ください②カスタムHTMLでショートコードを設置していない→固定ページなどにショートコードを埋め込む際は、カスタムHTMLで埋め込む必要があります。
Q. 詳細ページのショートコードを設置したのにテンプレートが表⽰されません。
A. 主な原因として考えられるのは以下の通りです。
①詳細ページが有効になっていない→表⽰設定画⾯からご確認ください。
②⼀覧・詳細ページのURLが正しくない→⼀覧・詳細ページ⽤のショートコードを設置したページのURLを⼊⼒してください。
Q. 当プラグインはWordPressのどの権限レベルのユーザが使⽤できますか︖
A.「編集者」以上の権限を持つユーザが使⽤できます。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

26

Q&A
Q. 店舗を登録したのに、テンプレートに表⽰されません。
A. 対象店舗の公開状態が「⾮公開」になっている可能性があります。
店舗⼀覧画⾯からご確認ください。
Q. 「エラーが発⽣しました。」と出てGoogle Mapがうまく表⽰されません。
A. Google Maps APIキーが正しく登録されているかを確認してください。
Q. ZIPインポート（テスト実⾏）とは何ですか︖
A. インポートしようとするZIPファイルの更新内容やエラー有無の確認のみを実⾏できます。
この操作では、登録・更新は⾏われません。
意図しない変更が起きることを避けるため、ZIPインポートする際は事前にテスト実⾏することをお勧めします。
Q. ZIPインポートで既に登録されている店舗を再登録すると、どうなりますか︖
A. インポートするCSVファイルの「id」が既に登録されている場合は、その店舗の情報が更新されます。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

27

Q&A
Q. ZIPインポートで複数の店舗を登録しようとしてエラーになった場合、エラーがあった店舗以外は登録・更新されますか︖
A. いいえ。⼀つでもエラーがあった場合、登録・更新は⾏われません。
Q. ZIPファイルやCSVファイルの雛形は無いのですか︖
A. 雛形は提供していませんが、ZIPエクスポート機能でダウンロードできるZIPファイルはインポートに使⽤できる形式です。
ZIPエクスポートして雛形がわりにお使いください。
Q. ZIPインポートでCSVファイルの id 列を空にして新規登録しました。
次回ZIPインポートする時はどうしたら良いですか︖
A. インポート時に店舗情報に id が追加されますので、インポート後は⼀度ZIPエクスポートして⼿元のCSVファイルを更新してください。
Q. ZIPインポートで店舗を削除できますか︖
A. できません。店舗の削除は管理画⾯の「店舗⼀覧」から実施してください。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

28

Q&A
Q. 複数の店舗で同じファイル名の店舗画像を使いまわすことは可能ですか︖
A. 同じファイル名を複数の店舗情報に登録することはできません。
同じ画像を使いたい場合は画像をコピーして別名で登録してください。
Q. CSVファイルの id がバラバラなのが気になるので、振り直してインポートしたいですA. ⾃動採番されるため店舗情報の id は揃わない場合がありますが、振り直しは以下の理由からお勧めしません。
••

ZIPインポート時は id を元に新規登録か更新かを判別しているため、番号の振り直しをするとインポートが失敗したり、意図しない変更結果になる可能性があります
店舗の個別ページURLが変わるため、Google などの検索エンジンに登録されている情報と⼀時的に⼀致しなくなります

Q. ZIPインポートで新規登録する際、 id を指定するとどうなりますか︖
A. 存在しない id であれば、その id で店舗を新規登録します。
すでに存在する id の場合は更新処理になってしまうのでお気をつけください。
id を⾃分でコントロールしたい理由がなければ、id の採番はプラグインによる⾃動採番に任せることをお勧めします。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

29

Q&A
Q. ZIPインポートで店舗を新規登録した後、再度ZIPインポートを実⾏すると「店舗名が重複しているため、更新処理を中断しました。」というエラーが出てインポートに失敗しました。
A. 新規登録した際に発⾏された id が、⼿元のCSVファイルに反映されていないためです。
⼀度ZIPエクスポートを実⾏し、⼿元のCSVファイルを更新してください。
Q. CSVファイルの id 列は何に使われるのですか︖
A. 店舗詳細ページの URL に使われます。また、ZIPインポート時にどの店舗情報を更新するべきか判別するために使われます。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

30

動作環境
■対応バージョン
WordPressバージョン︓6.0以降
検証済み最新バージョン︓6.4.3
PHPバージョン︓7.4以降

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

31

β版からのアップデートガイド「β版先⾏利⽤ユーザ募集」からβ版をダウンロードいただいたユーザ向けの情報です

公式版の公開にあたって、β版からの変更点があります。
詳細は p.33 を参照ください。
β版は公式版（WordPress公式プラグインサイトで公開しているバージョン）へ⾃動更新することができません。
⼀度β版をサイトから削除し、公式版をインストールしてください。
⼿順は p.34 を参照ください。

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

32

β版からのアップデートガイド: β版と公式版の変更点「β版先⾏利⽤ユーザ募集」からβ版をダウンロードいただいたユーザ向けの情報です・ショートタグが以下のように変更となりました。
β版

公式版

店舗⼀覧

[dsl_storelist][docosl_storelist]

店舗詳細[dsl_storedetail][docosl_storedetail]・ZIPファイルのファイル名が以下の通り変更されました。
β版

公式版

zipファイル名

dsl-stores.zip

docosl-stores.zip

解凍後のディレクトリ名

dsl-storesdocosl-stores

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

33

β版からのアップデートガイド: アップデート⽅法「β版先⾏利⽤ユーザ募集」からβ版をダウンロードいただいたユーザ向けの情報です
1. 「表⽰設定」の設定内容を⼿元に控える
本マニュアル p13 ~ p15 にある「表⽰設定」の設定内容をお⼿元に控えてください。（どこどこJPAPIキー、Google Maps APIキー、⼀覧ページ/詳細ページURLなど）
2. 店舗情報をエクスポートし、解凍後のフォルダ名を変更して圧縮「店舗⼀覧」ページの「ZIPエクスポート」ボタンを押して店舗情報をエクスポートします。
ZIPファイルを解凍し、解凍後のフォルダ名「dsl-stores」を「docosl-stores」に変更します。
「docosl-stores」ファイルを圧縮します。圧縮後のファイル名は「docosl-stores.zip」になります。
3. β版プラグインをサイトから削除
WordPress管理画⾯から「DocoDoco Store Locator」を削除します。
4. 管理画⾯から公式版をインストール「DocoDoco Store Locator」で検索して「今すぐインストール」をクリックします。

※次のページに続きます
Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

34

β版からのアップデートガイド: アップデート⽅法「β版先⾏利⽤ユーザ募集」からβ版をダウンロードいただいたユーザ向けの情報です

4. ダミーの店舗情報を削除
インストール直後は店舗情報の⼊⼒例として「店舗例1」「店舗例2」といった店舗が登録されています。インポートの際にエラーになる可能性があるため、「店舗⼀覧」画⾯からこれらの店舗を削除します。

4. ZIPインポートで docosl-stores.zip をインポート
5. 「表⽰設定」を元通りに設定する控えていただいた設定内容を再度ご設定ください。
6. ショートタグを変更する
固定ページなどに⼊⼒した店舗⼀覧/店舗詳細のショートタグを公式版のものに変更します。
Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

35

お問い合わせ先ご不明な点がございましたら、以下のメールアドレスにお問い合わせください。
◾問い合わせ先メールアドレス
wp-support@geolocation.co.jp

Copyright©2023 Geolocation Technology, Inc. All Rights Reserved.

36