説明
KUROFUNE LINK は、別サービスの有料 SEO サービス「KUROFUNE」と組み合わせて使うプラグインです。サイトの投稿に対して、次の 2 つを行います。
- Related posts. It adds a short list of related posts from the same site after the body of each post, so that new articles also receive links from older ones. KUROFUNE decides which posts are related, using its analysis of your articles, and delivers only pairs of post IDs. The plugin renders the list from your own WordPress data (titles, permalinks and featured images).
- Keeping KUROFUNE’s parts up to date. Posts written or rewritten with KUROFUNE can contain three kinds of marked parts: recommendation links (affiliate or product links you registered in KUROFUNE), call-to-action (CTA) blocks, and author cards. When you change one of them in KUROFUNE, KUROFUNE delivers the new link URL or block HTML, and the plugin shows it in place of the old one in every post that contains that marked part.
- 投稿本文は書き換えません。どちらも投稿 1 件を表示するときだけ行うので、プラグインを停止すれば、各投稿は保存されている内容どおりの表示に戻ります。
- 本文ですでにリンクしている投稿は、関連記事から外します。表示するのは、公開済みでパスワードの無い投稿だけです。
- The number of related posts (default 6) and the heading can be changed under Settings > KUROFUNE LINK, and the related-post list can be turned off there. That setting does not stop the updates of marked parts; deactivate the plugin to stop them.
- Delivered HTML is checked with WordPress’s own HTML filter (kses) when it is received, and anything that does not pass is not used. Delivered recommendation link URLs must use https.
- No “powered by” credit, no tracking of visitors, no cookies and no front-end JavaScript. The plugin itself never sends requests to KUROFUNE or any other server (see External services).
- For editors, the admin bar, the post editor and the posts list get “AI rewrite in KUROFUNE” (and “Edit in KUROFUNE” for posts KUROFUNE wrote) links that open the post in KUROFUNE.
KUROFUNE からの送信と解約
The plugin shows nothing until KUROFUNE sends the first delivery. An active KUROFUNE plan (including a trial), a WordPress connection, and KUROFUNE LINK being turned on are required for new deliveries.
After cancellation, the last delivered related posts and marked parts remain displayed, but changes are no longer reflected. Archiving the site or deleting its workspace in KUROFUNE also leaves the last delivery displayed. The plugin stays free to use after you cancel, and the last delivery keeps being shown. To stop the display, deactivate the plugin (activating it again shows the last delivery as before).
外部サービス
このプラグインは、株式会社KUROFUNE AI (https://www.kurofune-ai.co.jp/) が提供するサービス「KUROFUNE」の追加機能です。KUROFUNE がデータを送り始めるまでは何もしません。
What KUROFUNE sends to your site, and when. The plugin itself never contacts KUROFUNE or any other server. Instead, after you connect your site to KUROFUNE (with the WordPress Application Password of an Editor or Administrator that you register in KUROFUNE) and turn on KUROFUNE LINK there, KUROFUNE calls three REST API endpoints that this plugin adds to your site, periodically and when you change something in KUROFUNE:
POST /wp-json/kurofune-link/v1/sync– KUROFUNE sends: an identifier of your KUROFUNE site, a sequence number, how long that KUROFUNE site reserves this WordPress against another one, pairs of post IDs for related posts and their checksum, the IDs of the posts KUROFUNE wrote, the address of KUROFUNE (used only for the “Edit / AI rewrite in KUROFUNE” links), the current URLs of marked recommendation links, and the HTML of marked CTA blocks and author cards. The plugin stores these values in WordPress options on your site.GET /wp-json/kurofune-link/v1/status– KUROFUNE reads: the plugin version, your site’s home URL, the display setting, the detected page-cache plugin, since when a cache purge has been waiting, and whether another KUROFUNE site reserves this WordPress; for its own delivery, also the sequence number, a checksum of the stored post IDs, the remaining reservation time and when delivered items were last rejected.GET /wp-json/kurofune-link/v1/usage– 指定した推しリンク・CTA ブロック・執筆者カードが、どの公開済みの投稿に入っているかを KUROFUNE が問い合わせます。返すのは、公開済みの投稿の ID・タイトル・URL を最大 200 件です。
All three endpoints require a logged-in user with the edit_others_posts capability (Editor or above). Nothing about your visitors is sent to KUROFUNE.
訪問者のブラウザが読み込むもの。 推しリンクは、KUROFUNE に登録した行き先を指します。CTA ブロックと執筆者カードには、画像が入ることがあります。画像は、置いてある場所から訪問者のブラウザが読み込みます。置き場所は、サイトのメディアライブラリ、KUROFUNE の画像の保存先、KUROFUNE に入力した画像 URL のどれかです。投稿内のほかの画像やリンクと同じく、置き場所のサーバーには訪問者の IP アドレスとブラウザの情報が届きます。プラグインがこれに追跡を足すことはありません。
Links that open KUROFUNE. When an editor clicks “Edit in KUROFUNE” or “AI rewrite in KUROFUNE”, the browser opens KUROFUNE with this site’s host name, the post ID and the chosen action in the address. Nothing is sent until the link is clicked. The links open the KUROFUNE address named in KUROFUNE’s deliveries, and only if it is one of these two (or an address the site’s administrator adds in wp-config.php, see the FAQ):
- https://app.kurofune-ai.co.jp – お客様が使う KUROFUNE です。
- https://kurofune-web-stg-qk2qckvyua-uc.a.run.app – KUROFUNE の検証環境です。公開前の確認のため、KUROFUNE のスタッフと試験担当者だけが使います。リンクがここを開くのは、検証環境と連携した WordPress だけです。
KUROFUNE’s terms and privacy policy:
- KUROFUNE terms of service: https://www.kurofune-ai.co.jp/terms/
- KUROFUNE privacy policy: https://www.kurofune-ai.co.jp/privacy/
ソースコード
Everything in this plugin is shipped as human-readable source: the PHP, the stylesheet and the translation source (languages/*.po). There is no build step other than compiling the .po file into the bundled .mo file with gettext’s msgfmt. Development-only files (unit tests, coding-standards configuration) are left out of the zip.
インストール
- プラグインをインストールして、有効にします。
- In KUROFUNE, connect the site to WordPress (if not connected yet) and turn on KUROFUNE LINK in the site settings.
- 関連記事と、KUROFUNE で変えた推しリンク・CTA ブロック・執筆者カードは、KUROFUNE から次の送信が届いた後に表示されます。必要なら「設定 > KUROFUNE LINK」で、記事の数と見出しを変えます。
FAQ
-
何も表示されない
-
Before the first delivery, check that the KUROFUNE plan is active, KUROFUNE LINK is turned on for this site in KUROFUNE, and the site is connected with an Editor or Administrator account. Only articles that KUROFUNE has analysed get related posts. If a previous delivery existed, check whether KUROFUNE revoked it (for example, LINK was turned off for this site in KUROFUNE) or the plugin was deleted with “Also delete the content received from KUROFUNE and these settings” turned on and then installed again.
-
Turn off one of the two lists (in your theme settings or under Settings > KUROFUNE LINK) so that readers do not see two.
-
Which PHP does it need?
-
PHP 7.4 or later on a 64-bit build (the standard for current hosting). On 32-bit PHP, deliveries with large IDs or sequence numbers are refused rather than stored incorrectly.
-
Can I style the list?
-
Yes. The markup uses fixed class names starting with
kurofune-link(for example.kurofune-link__card), and the plugin’s stylesheet is intentionally minimal. -
What happens when I deactivate or delete the plugin?
-
Deactivating stops everything the plugin does, and posts show exactly their saved content again. The delivered data and the settings are kept, so activating the plugin again shows the last delivery as before. If KUROFUNE has revoked its delivery in the meantime (for example, you turned LINK off for the site), KUROFUNE normally sends the revoke again while this WordPress stays connected to the site, and the data is removed on its next delivery from KUROFUNE (usually in about 30 minutes). Deleting the plugin keeps them as well, so installing it again shows the last delivery as before. To remove them when the plugin is deleted, turn on “Also delete the content received from KUROFUNE and these settings” under Settings > KUROFUNE LINK before deleting (it is off by default).
-
リンクで別の KUROFUNE のアドレスを開きたい
-
The “Edit / AI rewrite in KUROFUNE” links only open the two addresses listed under External services. To let them open another KUROFUNE address, add it to
wp-config.php, for exampledefine( 'KUROFUNE_LINK_EXTRA_APP_URL', 'https://kurofune.example.com' );(https, no path). Deliveries work without this setting.
評価
このプラグインにはレビューがありません。
貢献者と開発者
変更履歴
1.3.4
- Image CTA blocks with a separate image for phones are accepted. KUROFUNE sends them as
<picture>with one<source>(media query and one https image URL) around the usual image; WordPress’s own HTML filter does not list these two tags, so the plugin allows them only while checking a delivered CTA block. A<source>whose image is not a single https URL is not used.
1.3.3
- The Status section of the settings screen was rebuilt as one card. A coloured banner says whether KUROFUNE is delivering (green), has stopped (yellow) or has not delivered anything yet (blue, with the three steps to start). Below it the card lists how many posts show recommendation links, CTA blocks and author cards, how many posts have related posts, when the last delivery arrived, how long until the update deadline, which KUROFUNE this WordPress is connected to, and a button that opens KUROFUNE. When updates have stopped it also lists the usual reasons and what to do.
- The time of the last delivery is now stored with the delivered data (the same option, removed on uninstall only when the delete setting is on). Until the next delivery arrives after updating, it shows “Unknown”.
- When updates from KUROFUNE have stopped (the update deadline has passed), a warning also appears on the Dashboard and the Plugins screen for administrators for 14 days after the deadline, with a link to the status.
- The advice about a theme or another plugin that already shows related posts moved from Status to the description of the Display setting.
- Deactivating or deleting the plugin no longer deletes the delivered data (recommendation links, CTA blocks, author cards, related posts); activating or reinstalling it shows the last delivery as before. A new setting, “Also delete the content received from KUROFUNE and these settings” (off by default, under Settings > KUROFUNE LINK), removes the delivered data and the settings when the plugin is deleted; each site of a network uses its own setting. Previously a mis-click on Deactivate lost the last delivery for good once updates from KUROFUNE had stopped (project archived or subscription cancelled). If KUROFUNE has revoked its delivery in the meantime, KUROFUNE sends the revoke again and it is removed on the next delivery from KUROFUNE (usually in about 30 minutes). The status card now also says the plugin stays free to use after cancellation.
1.3.2
- Settings screen: the description now also covers what KUROFUNE LINK has done since 1.1: it replaces recommendation links, CTA blocks and author cards with their latest KUROFUNE versions when a post is displayed. It also says which setting stops what: Display turns off only the related posts; deactivating the plugin stops the replacement. The plugin list description was updated the same way.
1.3.1
- “Edit / AI rewrite in KUROFUNE” links can also open KUROFUNE’s staging environment (used only by KUROFUNE staff and testers), so that the same published plugin works with both. The readme lists both addresses under External services.
1.3.0
- Author cards built by KUROFUNE are accepted on WordPress 6.5 – 6.x (the
displaystyle was refused there). - A delivered CTA block must be one complete block, so that it cannot change the rest of the post.
- A delivery that is in progress while the plugin is deactivated or deleted is discarded instead of saved.
- The delivery lock is unique per WordPress install, also when several installs share one MySQL server.
- With WP Super Cache on a multisite network, only the affected posts’ caches are cleared, never the whole cache.
- “Edit / AI rewrite in KUROFUNE” links open only the production KUROFUNE unless
KUROFUNE_LINK_EXTRA_APP_URLis defined. - Bundled translations are loaded by the plugin only on WordPress 6.5 – 6.7 or when network-activated; otherwise WordPress loads them.
- Deactivating and uninstalling also remove the scheduled cache purge.
- Readme: describe the external service, what is received and sent, and images loaded by visitors’ browsers.
1.2.0
- Update existing author cards marked with a persona ID when KUROFUNE sends new card HTML, without changing saved post content.
1.1.0
- Update marked recommendation links and CTA blocks when KUROFUNE sends new values, without changing the saved post content.
- Add a usage endpoint for published posts and deferred cache purging after live item changes.
1.0.3
- Posts KUROFUNE wrote get “Edit in KUROFUNE” and “AI rewrite in KUROFUNE”; other posts get “AI rewrite in KUROFUNE”. The admin bar shows them under one “KUROFUNE” item.
1.0.2
- “Open in KUROFUNE” in the admin bar, the post editor side column and the posts list (for users who can edit the post).
1.0.1
- Show 6 related posts by default, in 3 columns (2 on narrow screens) so the last row is always full.
- Default heading is now “You may also like” (Japanese: こちらもおすすめ).
- Refuse to report success when the assignment could not be saved; never show password-protected posts.
1.0.0
- First release.