Tốt — mình đã tạo plugin và đính kèm sẵn file ZIP. Dưới đây là bản plugin + hướng dẫn cài đặt CHI TIẾT (từng bước) và các lưu ý khi cấu hình Google API. Nếu bạn muốn mình thêm tính năng (lưu API key, lịch chạy tự động, export CSV, v.v.) mình có thể cập nhật plugin và gửi lại bản zip.

1) Tải plugin (.zip)

Tải plugin ZIP — multi-keyword-rank-checker.zip

2) Yêu cầu & chuẩn bị trước khi cài

• WordPress: bất kỳ site WordPress chuẩn (khuyến nghị dùng bản WP hiện hành).

• PHP: PHP trên server cần hỗ trợ HTTPS outbound (cURL hoặc allow_url_fopen). (Plugin gọi Google API qua HTTPS.)

• Quyền truy cập: admin WordPress (để cài/ kích hoạt) hoặc SFTP/SSH vào thư mục site nếu cài thủ công.

• Google: bạn cần 1 API Key và 1 Search Engine ID (cx) từ Google Programmable Search / Custom Search (xem phần 4 bên dưới để tạo). Bạn phải enable Custom Search JSON API cho project Google Cloud để gọi API. Google for DevelopersTrợ Giúp Google

3) Cài plugin — 3 cách (chi tiết)

Cách A — Qua WordPress Admin (dễ nhất)

1. Tải file ZIP về máy từ link ở trên.

2. Vào WordPress admin → Plugins → Add New → bấm Upload Plugin.

3. Chọn file multi-keyword-rank-checker.zip → Install Now → sau đó Activate.

4. Sau khi active, menu Rank Checker sẽ xuất hiện ở sidebar admin.

Cách B — Upload thủ công (FTP / SFTP)

1. Giải nén multi-keyword-rank-checker.zip trên máy tính — bạn sẽ có thư mục multi-keyword-rank-checker.

2. Dùng FTP/SFTP upload thư mục này lên wp-content/plugins/ của site.

3. Đặt quyền: folders 755, files 644 (tuỳ host).

4. Vào WP admin → Plugins → Active plugin.

Cách C — WP-CLI (trên server có WP-CLI)

1. Upload file ZIP lên server, ví dụ /tmp/multi-keyword-rank-checker.zip.

2. Chạy:

(hoặc wp plugin activate multi-keyword-rank-checker nếu đã upload thư mục).

4) Cấu hình Google (tạo API key & cx) — hướng dẫn từng bước

Tóm tắt nhanh: để plugin gọi được Google, bạn cần (1) một Google Cloud Project với Custom Search API được enabled, (2) một API key, (3) một Programmable Search Engine (CSE) để lấy Search engine ID (cx). Google for Developers+1

4.1 Tạo project & bật API

1. Vào Google Cloud Console → tạo hoặc chọn Project.

2. Vào APIs & Services → Library, tìm Custom Search API (hoặc Custom Search JSON API) → Enable. (Nếu cần billing để tăng quota, bật billing cho project). Trợ Giúp GoogleGoogle Cloud

4.2 Tạo API key

1. Vào APIs & Services → Credentials → Create credentials → API key.

2. SAU KHI TẠO: giới hạn key (restrictions) theo IP hoặc HTTP referer nếu có thể — giảm rủi ro lộ key. Trợ Giúp GoogleGoogle Cloud

4.3 Tạo Programmable Search Engine (lấy cx)

1. Vào trang Programmable Search Engine (Programmable Search Engine control panel). Tạo một Search Engine mới.

2. Khi tạo, mục Sites to search có thể mặc định yêu cầu site — bạn có thể:

   • Thêm domain của bạn để search chỉ trong site đó; hoặc

   • Sau khi tạo, vào Edit → Basics → Sites to search → chọn Search the entire web (hoặc “Search the entire web but emphasize included sites”) để dùng API cho toàn web — rồi lưu. Việc chuyển sang “search the entire web” thường được thực hiện trong phần cài đặt của CSE. Google for DevelopersStack Overflow

3. Trong control panel bạn sẽ thấy Search engine ID (một chuỗi — đó là cx) — copy giá trị này.

4.4 Kiểm tra API (ví dụ curl)

Thử gọi API đơn giản:

Kết quả trả về là JSON; trường items chứa kết quả. Nếu không có items hoặc xuất hiện error, kiểm tra API key / cx / quota / setting của CSE. Google for Developers

4.5 Lưu ý quota & giá

• Mặc định 100 truy vấn/ngày miễn phí; nếu cần nhiều hơn bạn phải bật billing — giá tham khảo ~$5 / 1000 queries, giới hạn tối đa khoảng 10,000/day với Custom Search JSON API. (Kiểm tra bảng giá & quota trong docs). Google for Developers+1

5) Cách dùng plugin (sau khi active)

1. Vào Rank Checker (menu mới).

2. Nhập 4 mục: Domain (ví dụ example.com — plugin check host/link có chứa domain), API Key, Search Engine ID (cx), chọn Top N (10/20/50), và dán danh sách từ khóa (mỗi dòng 1 từ khóa).

3. Nhấn Kiểm tra → plugin gọi Google CSE tuần tự (mỗi page 10 kết quả) và trả về bảng: Keyword | Position | URL.

4. Nếu từ khóa không nằm trong Top N đã chọn → hiện “Not in top N”.

Ghi chú: plugin hiện gọi API theo từng từ khóa tuần tự. Nếu bạn kiểm tra nhiều từ khóa (ví dụ > 100), sẽ tạo nhiều request → có thể vượt quota hoặc tốn tiền. Nên batch, throttle, hoặc lưu cache/ lịch chạy định kỳ.

6) Troubleshooting — lỗi thường gặp & cách khắc phục

• Không trả về items / kết quả rỗng → kiểm tra cx (CSE có được cấu hình để search web hay chỉ search 1 site?), và API key. Google for Developers

• 403 / API key invalid → API chưa được enable cho project, hoặc API key bị restriction sai. Kiểm tra APIs & Services → Enabled APIs. Trợ Giúp Google

• Quota exceeded / billing required → kiểm tra giới hạn miễn phí (100/ngày) và bật billing nếu cần. Google for Developers

• Server không gọi được Google → kiểm tra firewall/hosting chặn outbound HTTPS; cần cURL/allow_url_fopen hoạt động.

• Chậm / timeouts → plugin gọi nhiều request tuần tự; giảm số từ khóa mỗi lần, tăng usleep giữa request, hoặc chạy qua background cron (mình có thể thêm tính năng này).

7) Bảo mật & tối ưu

• KHÔNG đặt API key công khai trên trang; plugin hiện yêu cầu nhập key trong admin (server-side). Bạn có thể yêu cầu mình cập nhật để lưu API key an toàn vào wp_options với quyền chỉ admin.

• Giới hạn API key (HTTP referrer/IP) để tránh lộ key. Google Cloud

• Để kiểm tra hàng loạt tốt hơn: thêm caching kết quả, lập lịch (cron) và lưu lịch sử để so sánh thứ hạng theo thời gian.

8) Muốn mở rộng tính năng — gợi ý (mình có thể cập nhật)

• Lưu API key & CX trong trang Settings (mã hoá / ẩn input).

• Lên lịch tự động (WP Cron) để chạy hàng ngày và lưu lịch sử.

• Xuất kết quả CSV / Excel / PDF.

• Thay Google CSE bằng SerpAPI / DataForSEO / Ahrefs (nếu cần độ chính xác/khả năng mở rộng/bỏ quảng cáo).

Nếu bạn muốn, mình sẽ:

• 1. Gửi lại bản plugin đã thêm: (a) trang Settings để lưu API key & cx, (b) export CSV, (c) cron để chạy hàng ngày — và đóng gói ZIP rồi gửi link tải trực tiếp.

• 2. Hoặc chỉ muốn hướng dẫn thêm (ví dụ: cách giới hạn API key, cách bật billing), mình sẽ viết bước chi tiết ngay.

Bạn muốn mình cập nhật plugin theo mục (1) bên trên luôn chứ? Nếu có, mình sẽ tạo và gửi file ZIP mới ngay lập tức.