توضیحات
Citrus یک افزونه مدرن وردپرس است که انتشارات پژوهشی را بهزیبایی در وبسایت شما نمایش میدهد. میتوانید بین همگامسازی خودکار از Pure API یا ورود دستی دادههای BibTeX (جایگذاری یا بارگذاری) یکی را انتخاب کنید. این افزونه برای دانشگاهها، مؤسسات پژوهشی و گروههای آموزشی ایدهآل است.
ویژگیهای کلیدی:
- منابع داده منعطف: از همگامسازی خودکار Pure API استفاده کنید یا دادههای BibTeX را بهصورت دستی ارائه دهید (جایگذاری یا بارگذاری)
- همگامسازی خودکار از Pure API (زمانبندی ساعتی، دوبار در روز یا روزانه)
- ورود دستی BibTeX: محتوای موردنظر را مستقیماً جایگذاری کنید یا فایلهای .txt را بارگذاری کنید
- کش هوشمند با Transientهای وردپرس برای کاهش فراخوانیهای API
- فهرستهای زیبای انتشارات با طراحی واکنشگرا، جستوجو و فیلتر
- چندین روش یکپارچهسازی: کدکوتاه، بلوک گوتنبرگ و REST API
- خلاصههای اختیاری مبتنی بر هوش مصنوعی (سازگار با OpenAI) با کش 24 ساعته و محدودسازی نرخ
- 6 طرح رنگی + پشتیبانی از CSS سفارشی
- طراحی در دسترسپذیر و واکنشگرا با حالت تیره
- مدیریت امن گزینهها و نقاط پایانی REST محافظتشده با nonce
پیشنیازها
- وردپرس 5.8 یا بالاتر
- PHP 7.4 یا بالاتر
- برای حالت Pure API: اطلاعات دسترسی Pure API نسخه 5.24 (Web Service نسخهبندیشده قدیمی) شامل کلید API و شناسه سازمان
- برای حالت ورود دستی: دادههای BibTeX از مدیر منابع شما (قابل جایگذاری یا بارگذاری بهصورت فایل .txt)
- (اختیاری) کلید API سازگار با OpenAI برای قابلیتهای هوش مصنوعی
توجه: حالت Pure API برای Pure API نسخه 5.24، یعنی آخرین نسخه از Web Service نسخهبندیشده قدیمی، طراحی و آزمایش شده است. ممکن است با Pure API جدید سازگار نباشد.
سرویسهای خارجی
این افزونه برای ارائه قابلیتهای خود به سرویسهای خارجی شخص ثالث متصل میشود. در ادامه، اطلاعات تفصیلی هر سرویس آمده است:
Pure API
این چیست: Pure یک سامانه مدیریت اطلاعات پژوهشی (RIMS) است که دانشگاهها و مؤسسات پژوهشی برای مدیریت دادههای انتشارات از آن استفاده میکنند. این افزونه برای دریافت فراداده انتشارات به Pure API سازمان شما متصل میشود.
کاربرد آن: دریافت و همگامسازی دادههای انتشارات پژوهشی (عنوانها، نویسندگان، چکیدهها، سالهای انتشار و غیره) از سیستم Pure سازمان شما برای نمایش در سایت وردپرسیتان.
چه دادهای ارسال میشود: کلید Pure API و شناسه سازمان شما همراه هر درخواست ارسال میشوند تا احراز هویت انجام شود و مشخص شود انتشارات کدام واحد سازمانی باید دریافت شوند. هیچ داده کاربر یا اطلاعات بازدیدکنندهای به Pure منتقل نمیشود.
زمان ارسال داده: داده در این شرایط ارسال میشود:
– اتصال API را در تنظیمات افزونه آزمایش کنید
– از طریق پیشخوان مدیریت یا REST API بهصورت دستی همگامسازی را اجرا کنید
– همگامسازی زمانبندیشده خودکار اجرا شود (ساعتی، دوبار در روز یا روزانه، بر اساس تنظیمات شما)
ارائهدهنده سرویس: نصب Pure متعلق به سازمان شما (خودمیزبان یا مدیریتشده توسط Elsevier)
حریم خصوصی و شرایط: لطفاً برای اطلاع از نحوه مدیریت دادهها، سیاستهای حریم خصوصی و شرایط استفاده مرتبط با نصب Pure خود، با مدیر سیستم Pure سازمانتان مشورت کنید.
OpenAI API (اختیاری)
این چیست: OpenAI مدلهای هوش مصنوعی ارائه میدهد که میتوانند متن را تحلیل و خلاصه کنند. این افزونه بهصورت اختیاری از APIهای سازگار با OpenAI برای تولید خلاصه انتشارات پژوهشی استفاده میکند.
کاربرد آن: تولید خلاصههای مبتنی بر هوش مصنوعی از انتشارات انتخابشده، هنگامی که کاربران روی دکمه «Generate AI Summary» در بخش کاربری کلیک میکنند.
چه دادهای ارسال میشود: فراداده انتشارات انتخابشده (عنوانها، چکیدهها و سالها) به نقطه پایانی API هوش مصنوعی پیکربندیشده ارسال میشود (بهصورت پیشفرض https://api.openai.com/v1/chat/completions). برای 10 انتشار یا کمتر، چکیدههای کامل ارسال میشوند. برای بیش از 10 انتشار، فقط عنوانها و سالها ارسال میشوند. هیچ اطلاعات بازدیدکننده یا داده شخصی منتقل نمیشود.
زمان ارسال داده: داده فقط در این شرایط ارسال میشود:
– کاربر بهطور صریح روی دکمه «Generate AI Summary» در بخش کاربری کلیک کند
– قابلیتهای هوش مصنوعی در تنظیمات افزونه فعال شده باشند
– درخواست قبلاً کش نشده باشد (خلاصهها بهمدت 24 ساعت کش میشوند)
ارائهدهنده سرویس: OpenAI (پیشفرض) یا هر سرویس API سازگار با OpenAI که پیکربندی کنید
شرایط و حریم خصوصی:
– شرایط استفاده OpenAI: https://openai.com/policies/terms-of-use
– سیاست حریم خصوصی OpenAI: https://openai.com/policies/privacy-policy
– اگر از یک سرویس جایگزین سازگار با OpenAI استفاده میکنید، لطفاً شرایط و سیاست حریم خصوصی همان ارائهدهنده را بررسی کنید
توجه: قابلیتهای هوش مصنوعی کاملاً اختیاری هستند و بهصورت پیشفرض غیرفعالاند. افزونه بدون یکپارچهسازی هوش مصنوعی نیز بهطور کامل کار میکند.
نحوه استفاده
کدکوتاه
در هر برگه یا نوشتهای قرار دهید:
[citrus_publications]
با فیلترها:
[citrus_publications author=”Smith” year=”2024″ limit=”10″]
فعالسازی دکمه خلاصه هوش مصنوعی:
[citrus_publications enable_ai_summary=”true”]
بلوک گوتنبرگ
بلوک «Pure Publications» را اضافه کنید و فیلترها را در تنظیمات بلوک پیکربندی کنید.
REST API
- دریافت انتشارات (BibTeX): /wp-json/citrus/v1/publications
- دریافت انتشارات (JSON): /wp-json/citrus/v1/publications/json
- اجرای همگامسازی (POST): /wp-json/citrus/v1/sync (نیازمند احراز هویت)
عکسهای صفحه
نصب
- پوشه
citrusرا در مسیر/wp-content/plugins/بارگذاری کنید، یا افزونه را از طریق صفحه افزونههای وردپرس نصب کنید. - افزونه را از طریق منوی «افزونهها» در وردپرس فعال کنید.
- از منوی مدیریت وردپرس به Citrus بروید.
- منبع داده خود را انتخاب کنید:
- Pure API: اطلاعات دسترسی Pure API خود (کلید API و شناسه سازمان) را برای همگامسازی خودکار وارد کنید.
- ورود دستی: دادههای BibTeX خود را مستقیماً جایگذاری کنید یا یک فایل .txt حاوی انتشارات خود را بارگذاری کنید.
- (اختیاری) قابلیتهای هوش مصنوعی و تنظیمات ظاهری را پیکربندی کنید.
سوالات متداول
-
آیا میتوانم بدون دسترسی به Pure API از این افزونه استفاده کنم؟
-
بله! از نسخه 1.2.0 به بعد، میتوانید بهجای استفاده از Pure API، دادههای BibTeX را بهصورت دستی ارائه کنید. کافی است در تنظیمات، «بارگذاری دستی» را بهعنوان منبع داده خود انتخاب کنید، سپس محتوای BibTeX را جایگذاری کرده یا یک فایل .txt بارگذاری کنید.
-
آیا به دسترسی Pure API نیاز دارم؟
-
خیر، دسترسی به Pure API اختیاری است. شما میتوانید یکی از این موارد را انتخاب کنید:
– حالت Pure API: همگامسازی خودکار از سیستم Pure سازمان شما (نیازمند اطلاعات دسترسی API)
– حالت ورود دستی: جایگذاری دادههای BibTeX یا بارگذاری فایل .txtبرای حالت Pure API، به اطلاعات دسترسی از سیستم Pure سازمان خود (کلید API و شناسه سازمان) نیاز دارید. این افزونه برای Pure API نسخه 5.24 (آخرین نسخه از Web Service نسخهبندیشده قدیمی) طراحی شده است و ممکن است با Pure API جدید سازگار نباشد. با مدیر سیستم Pure خود تماس بگیرید.
-
چرا نمیتوانم فایلهای .bib را مستقیماً بارگذاری کنم؟
-
وردپرس به دلایل امنیتی برخی از انواع فایلها، از جمله فایلهای .bib و .bibtex را محدود میکند. برای دور زدن این موضوع، دو راه آسان دارید:
1. دادههای BibTeX خود را مستقیماً در ناحیه متنی جایگذاری کنید (پیشنهادی)
2. فایل .bib خود را با پسوند .txt ذخیره کنید و بهجای آن همان را بارگذاری کنیدهر دو روش بهخوبی کار میکنند – افزونه محتوای BibTeX را در هر دو حالت به یک شکل پردازش میکند.
-
چگونه دادههای BibTeX را از مدیر منابع خود دریافت کنم؟
-
بیشتر مدیران منابع میتوانند به قالب BibTeX برونبری کنند:
– Zotero: File Export Library Format: BibTeX
– Mendeley: File Export BibTeX (*.bib)
– EndNote: File Export Output Style: BibTeX Exportپس از برونبری، میتوانید یکی از این کارها را انجام دهید:
1. فایل .bib را در یک ویرایشگر متن باز کنید، محتوای آن را کپی کرده و در Citrus جایگذاری کنید
2. نام فایل .bib را به .txt تغییر دهید و آن را بارگذاری کنید -
برای بارگذاری دستی باید از چه قالب BibTeX استفاده کنم؟
-
هر قالب استاندارد BibTeX کار خواهد کرد. دادههای شما باید شامل ورودیهایی مانند @article، @inproceedings، @book و غیره باشد. افزونه فیلدهای استاندارد BibTeX از جمله title، author، year، journal، booktitle، publisher و موارد دیگر را پردازش میکند.
-
آیا میتوانم بین Pure API و ورود دستی جابهجا شوم؟
-
بله، شما میتوانید در هر زمان منبع داده خود را در تنظیمات افزونه تغییر دهید. وقتی حالت را تغییر میدهید، افزونه از منبع داده مناسب برای نمایش انتشارات استفاده میکند.
-
آیا قابلیتهای هوش مصنوعی ضروری هستند؟
-
خیر. قابلیتهای هوش مصنوعی اختیاری هستند. این افزونه بدون هوش مصنوعی نیز کاملاً کار میکند. اگر آن را فعال کنید، به یک کلید API سازگار با OpenAI نیاز خواهید داشت.
-
دادهها کجا ذخیره میشوند؟
-
دادههای BibTeX و فایلهای کششده در
wp-content/uploads/citrus/ذخیره میشوند، نه در داخل پوشه افزونه. این کار دادهها را هنگام بهروزرسانی افزونه ایمن نگه میدارد و نیاز به ویرایش فایلهای افزونه توسط کاربران را برطرف میکند. -
آیا دادههای من امن هستند؟
-
بله. کلیدهای API بهصورت امن در گزینههای وردپرس ذخیره میشوند و هرگز در سمت کاربر نمایش داده نمیشوند. فقط فراداده انتشارات (عنوانها، چکیدهها و سالها) هنگام تولید خلاصهها ممکن است برای ارائهدهنده هوش مصنوعی ارسال شود.
-
آیا با پوسته من کار میکند؟
-
بله. Citrus از CSS تمیز و مدرنی استفاده میکند که با هر پوستهای سازگار میشود و از حالت تیره پشتیبانی میکند.
-
چگونه میتوانم ظاهر را شخصیسازی کنم؟
-
از میان 6 طرح رنگی داخلی انتخاب کنید یا از طریق صفحه تنظیمات، CSS سفارشی اضافه کنید. متغیرهای CSS برای شخصیسازی آسان در دسترس هستند.
نقد و بررسیها
نقد و بررسیای برای این افزونه یافت نشد.
توسعه دهندگان و همکاران
“Citrus” به 1 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمکهایشان.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
1.2.2
- نگارش سازگار با وردپرس 7.0
- فرادادهٔ ثبت بلوک برای ویرایشگر iframe بهروزرسانی شد
- تراز آیکون دکمههای اقدام مدیریتی Citrus در سبکهای تازهسازیشدهٔ مدیریت بهبود یافت
- فرادادهٔ سازگاری به وردپرس 7.0 بهروزرسانی شد
1.2.0
- ویژگی جدید: ورود دستی دادههای BibTeX (جایگذاری یا بارگذاری)
- افزودن ناحیه متنی برای جایگذاری مستقیم محتوای BibTeX
- پشتیبانی از بارگذاری فایلهای .txt حاوی دادههای BibTeX
- افزودن انتخاب منبع داده: Pure API یا ورود دستی
- افزایش انعطافپذیری برای کاربرانی که به Pure API دسترسی ندارند
- بهبود رابط مدیریت با راهنمایی بهتر برای کاربران
- بهروزرسانی مستندات برای هر دو حالت منبع داده
1.1.2
- افزودن مستندات جامع سرویسهای خارجی برای Pure API و OpenAI API
- شفافسازی مجوزهای نقاط پایانی REST API با توضیحات درونخطی
- انتقال نقطه پایانی انتشارات به مسیرهای مبتنی بر وردپرس برای امنیت بهتر
- بهبودهای انطباق با مخزن وردپرس
1.1.1
- انتشار نگهداری و بهروزرسانیهای مستندات
- اصلاحات جزئی و پرداخت نهایی برای همراستایی با رهنمودهای مخزن
1.1.0
- قابلیتهای هوش مصنوعی – یکپارچهسازی API سازگار با OpenAI برای خلاصههای انتشارات
- تنظیمات ظاهر – 6 طرح رنگی همراه با پشتیبانی از CSS سفارشی
- امنیت ارتقایافته – محدودسازی نرخ و بهبود مدیریت کلید API
- بهبودهای عملکرد – کش 24 ساعته خلاصه هوش مصنوعی
- تجربه کاربری بهتر – بهبود رابط مدیریت با پیشخوان بصری