內容簡介
<span>總結：</span>
<ul>
<li>Citrus 是一個現代的 WordPress 外掛，可以在您的網站上美觀地顯示研究出版物，適用於大學、研究機構和學術部門。您可以從 Pure API 自動同步或手動輸入 BibTeX 資料。</li>
</ul>
<span>問題與答案：</span>
<ul>
<li><strong>這個外掛的關鍵特點是什麼？</strong>
<ul>
<li>靈活的資料來源：使用 Pure API 自動同步或手動提供 BibTeX 資料（貼上或上傳）。</li>
<li>從 Pure API 自動同步（按照設定的時間表：每小時、每天兩次或每天一次）。</li>
<li>手動輸入 BibTeX：直接貼上內容或上傳 .txt 檔案。</li>
<li>智能快取功能，使用 WordPress transients 以減少 API 呼叫。</li>
<li>美觀、具有響應性的出版物清單，可進行搜尋和篩選。</li>
<li>多種整合選項：短碼、Gutenberg 區塊和 REST API。</li>
<li>可選的 AI 摘要功能（與 OpenAI 相容），具有 24 小時的快取和速率限制。</li>
<li>6 種色彩方案 + 自訂 CSS 支援。</li>
<li>具有暗黑模式的可存取、具有響應性的設計。</li>
<li>安全的選項處理和受安全性保護的 REST 端點。</li>
</ul>
</li>
<li><strong>這個外掛的需求是什麼？</strong>
<ul>
<li>WordPress 5.8 或更高版本。</li>
<li>PHP 7.4 或更高版本。</li>
<li>對於 Pure API 模式：Pure API 版本 5.24（遺留版本化 Web 服務）訪問憑證（API 金鑰和組織 ID）。</li>
<li>對於手動輸入模式：來自您的參考管理器的 BibTeX 資料（可以貼上或上傳為 .txt 檔案）。</li>
<li>（可選）用於 AI 功能的 OpenAI 相容 API 金鑰。</li>
</ul>
</li>
<li><strong>此外掛連接的外部服務有哪些？</strong>
<ul>
<li><strong>Pure API：</strong>
<ul>
<li>它是什麼：Pure 是一個由大學和研究機構使用的研究信息管理系統（RIMS），用於管理出版物數據。這個外掛連接到您機構的 Pure API 以檢索出版物元數據。</li>
<li>它用於什麼：從您機構的 Pure 系統中檢索和同步研究出版物數據（標題、作者、摘要、出版年等），以在您的 WordPress 網站上顯示。</li>
<li>傳送的數據：每個請求均傳送您的 Pure API 金鑰和組織 ID 以進行身份驗證，並指定要檢索哪個組織部門的出版物。不會傳輸任何用戶數據或訪問者信息到 Pure。</li>
<li>何時傳送數據：當您在外掛設置中測試 API 連接時、您手動通過管理儀表板或 REST API 觸發同步時、根據您的設置運行的自動排程同步（每小時、每天兩次或每天一次）時。</li>
<li>服務提供者：您自己的機構的 Pure 安裝（自行託管或由 Elsevier 管理）。</li>
<li>隱私和條款：請諮詢您機構的 Pure 系統管理員，以瞭解關於數據處理、隱私政策和使用條款的具體信息，這些信息是針對您的 Pure 安裝而設的。</li>
</ul>
</li>
<li><strong>OpenAI API（可選）：</strong>
<ul>
<li>它是什麼：OpenAI 提供能夠分析和摘要文本的人工智能模型。這個外掛可以選擇使用 OpenAI 兼容的 API 生成研究出版物的摘要。</li>
<li>它用於什麼：當用戶在前端點擊「生成 AI 摘要」按鈕時，生成所選出版物的人工智能摘要。</li>
<li>傳送的數據：所選出版物的出版物元數據（標題、摘要和年份）被發送到配置的 AI API 端點（默認為 https://api.openai.com/v1/chat/completions）。對於10篇或更少的出版物，將發送完整摘要；對於超過10篇出版物，只發送標題和年份。不會傳輸訪問者信息或個人數據。</li>
<li>何時傳送數據：僅在用戶明確點擊前端的「生成 AI 摘要」按鈕時，AI 功能在外掛設置中啟用時，請求未被緩存時（摘要將被緩存24小時）時才會傳送數據。</li>
<li>服務提供者：OpenAI（默認）或您配置的任何 OpenAI 兼容 API 服務。</li>
</ul>
</li>
</ul>
</li>
</ul>
外掛標籤
開發者團隊
原文外掛簡介
Citrus is a modern WordPress plugin that displays research publications beautifully on your website. Choose between automatic synchronization from the Pure API or manual entry of BibTeX data (paste or upload). Ideal for universities, research institutions, and academic departments.
Key features:
Flexible Data Sources: Use Pure API automatic sync OR manually provide BibTeX data (paste or upload)
Automatic synchronization from Pure API (schedule hourly, twice daily, or daily)
Manual BibTeX entry: Paste content directly or upload .txt files
Smart caching with WordPress transients to reduce API calls
Beautiful, responsive publication listings with search and filters
Multiple integration options: shortcode, Gutenberg block, and REST API
Optional AI-powered summaries (OpenAI-compatible) with 24-hour caching and rate limiting
6 color schemes + custom CSS support
Accessible, responsive design with dark mode
Secure options handling and nonce-protected REST endpoints
Requirements
WordPress 5.8 or higher
PHP 7.4 or higher
For Pure API mode: Pure API version 5.24 (legacy versioned Web Service) access credentials (API key and organization ID)
For Manual Entry mode: BibTeX data from your reference manager (can be pasted or uploaded as .txt file)
(Optional) OpenAI-compatible API key for AI features
Note: Pure API mode is designed and tested with Pure API version 5.24, the final version of the legacy versioned Web Service. It may not be compatible with the new Pure API.
External Services
This plugin connects to external third-party services to provide its functionality. Below is detailed information about each service:
Pure API
What it is: Pure is a research information management system (RIMS) used by universities and research institutions to manage publication data. This plugin connects to your institution’s Pure API to retrieve publication metadata.
What it’s used for: Fetching and synchronizing research publication data (titles, authors, abstracts, publication years, etc.) from your institution’s Pure system to display on your WordPress site.
What data is sent: Your Pure API key and Organization ID are sent with each request to authenticate and specify which organizational unit’s publications to retrieve. No user data or visitor information is transmitted to Pure.
When data is sent: Data is sent when:
– You test the API connection in the plugin settings
– You manually trigger a sync via the admin dashboard or REST API
– An automatic scheduled sync runs (hourly, twice daily, or daily, based on your settings)
Service provider: Your own institution’s Pure installation (self-hosted or managed by Elsevier)
Privacy and Terms: Please consult your institution’s Pure system administrator for information about data handling, privacy policies, and terms of use specific to your Pure installation.
OpenAI API (Optional)
What it is: OpenAI provides artificial intelligence models that can analyze and summarize text. This plugin optionally uses OpenAI-compatible APIs to generate summaries of research publications.
What it’s used for: Generating AI-powered summaries of selected publications when users click the “Generate AI Summary” button on the frontend.
What data is sent: Publication metadata (titles, abstracts, and years) of the selected publications is sent to the configured AI API endpoint (defaults to https://api.openai.com/v1/chat/completions). For 10 or fewer publications, full abstracts are sent. For more than 10 publications, only titles and years are sent. No visitor information or personal data is transmitted.
When data is sent: Data is only sent when:
– A user explicitly clicks the “Generate AI Summary” button in the frontend
– AI features are enabled in the plugin settings
– The request hasn’t been cached (summaries are cached for 24 hours)
Service provider: OpenAI (default) or any OpenAI-compatible API service you configure
Terms and Privacy:
– OpenAI Terms of Use: https://openai.com/policies/terms-of-use
– OpenAI Privacy Policy: https://openai.com/policies/privacy-policy
– If using an alternative OpenAI-compatible service, please consult that provider’s terms and privacy policy
Note: AI features are completely optional and disabled by default. The plugin works fully without AI integration.
Usage
Shortcode
Place on any page or post:
[citrus_publications]
With filters:
[citrus_publications author=”Smith” year=”2024″ limit=”10″]
Enable AI summary button:
[citrus_publications enable_ai_summary=”true”]
Gutenberg Block
Add the “Pure Publications” block and configure filters in the block settings.
REST API
Get publications (BibTeX): /wp-json/citrus/v1/publications
Get publications (JSON): /wp-json/citrus/v1/publications/json
Trigger sync (POST): /wp-json/citrus/v1/sync (requires authentication)
