نگارش 1.0

راهنمای افزونه دریافت اطلاعات فیلم و سریال

درباره افزونه

به کمک این افزونه می توانید با یک جستوجوی ساده، اطلاعات فیلم یا سریال مورد نظرتان(شامل:پوستر،نام،سال تولید،کارگردان،نویسنده،ستارگان،و...) را به دست آورید. و در هر کجای سایتتان نمایش دهید.

راهنمای نصب

این افزونه در دو مرحله ی بسیار ساده نصب می شود.

  1. 1) ریختن پوشه افزونه در مسیر wp-content/plugins (مثال:example.com/wp-content/plugins/imdb-info)
  2. 2) فعال سازی افزونه در صفحه مدیریت افزونه ها

    3. وردپرس شما باید در ریشه هاست (root) نصب شده باشد. در صورتی که آنرا در یک پوشه نصب کرده باشید افزونه غیر فعال خواهد شد

راهنمای استفاده

برای استفاده از افزونه مراحل زیر را دنبال کنید

  1. 1) وارد صفحه افزودن نوشته شوید
  2. 2) روی دکمه افزودن اطلاعات IMDB کلیک کنید (مطابق شکل زیر)

    3. screen shot 1

  3. 3) در صفحه پاپ آپ باز شده (ThickBox) در کادر جستجو نام فیلم یا سریال مورد نظر را (بدون درج سال تولید) بنویسید سپس روی ناحیه آبی مشخص شده کلیک کنید.

    4. screen shot 2

  4. 4) پس از چند ثانیه (حدود 10-60 ثانیه، وابسته به فاصله مکانی سرور سایت شما تا سرور OMDB API) مانند تصویر زیر لیست 10 فیلم و سریالی که عبارت "fargo" در آنها وجود دارد نمایش داده می شود، روی عنوان مورد نظر کلیک کنید (جهت حصول اطمینان از اطلاعات و دریافت شناسه مخصوص).

    5. screen shot 3

  5. 5) پس از صحت محتوا مقدار شناسه ای ام دی بی را کپی کنید (در این مثال tt2802850) و در صورت عدم صحت محتوا روی دکمه ریست کلیک کرده و دوباره جستجو کنید.

    6. screen shot 4

  6. 6) مقدار درون شناسه ای ام دی بی را در متاباکس مربوط به همین افزونه قرار دهید سپس مطلب را منتشر کنید.

    7. screen shot 5

نکات مهم

رعایت نکات زیر در استفاده از افزونه الزامی است.

  1. 1) درصورتی که پس از وارد کردن عنوان فیلم یا سریال نتیجه ای نمایش داده نشد فقط چند کلمه از عنوان مورد نظر را تایپ نمایید (حداقل سه کلمه)
  2. 2) شناسه ای ام دی بی همیشه با دو حرف tt شروع می شود.
  3. 3) آدرس پوستر های این افزونه هنوز ثابت نیست و امکان فیلتر شدن دامنه آن وجود دارد (البته این فقط یک احتمال ناچیز است) به هر حال در صورت فیلتر شدن دامنه تصاویر این افزونه به صورت خودکار تصویر شاخص نوشته را در نظر می گیرد.

عملکرد تابع(های) افزونه و نحوه استفاده از آن

خب! کمی بالا تر یاد گرفتین که چطوری افزونه رو نصب و اطلاعات رو دریافت کنید. حالا سوال اصلی اینجاست : چطوری از افزونه خروجی بگیریم؟

برای نمایش خروجی(های) افزونه در هرکجای پوسته سایت از تابع ()Get_IMDBI استفاده می کنیم که سه پارامتر (action,poster_callback,callback) دارد.

  • پارامتر action (الزامی- رشته)
    1. Title (عنوان)
    2. Year (سال تولید)
    3. Rated (رده سنی)
    4. Released (تاریخ دقیق تولید، روز-ماه-سال)
    5. Runtime (مدت زمان)
    6. Genre (ژانر یا موضوع)
    7. Director (کارگردان)
    8. Writer (نویسنده)
    9. Actors (ستاره های فیلم یا سریال)
    10. Plot (خلاصه داستان - به انگلیسی)
    11. Language (زبان)
    12. Country (کشور ساخت)
    13. Metascore (چکیده امتیازات - معمولا فاقد مقدار است)
    14. imdbRating (رتبه فیلم در ای ام دی بی)
    15. imdbVotes (تعداد رای دهندگان)
    16. imdbID (شناسه ای ام دی بی)
    17. Type (نوع: فیلم-سریال-بازی-تریلر)
    18. Poster (پوستر در اندازه 300x300)

حروف اول هر مقدار باید بزرگ نوشته شود.

  • پارامتر poster_callback (اختیاری - بولی - پیش فرض true)
    1. True
    2. False

پارامتر poster_callback درصورت وجود پوستر آنرا نمایش می دهد و در صورت نبود آن از تصویر شاخص استفاده می کند اما اگر مقدار این پارامتر False باشد در صورت وجود پوستر باز هم از تصویر شاخص استفاده می کند.

  • پارامتر callback (اختیاری - بولی - پیش فرض true)
    1. True
    2. False

پارامتر callback در صورت عدم اتصال به پایگاه داده ی imdb خطای مربوطه را برگشت می دهد. و در صورت false بودن مقدار این پارامتر،چیزی نمایش داده نخواهد شد

مثال ها

شکل دستوری تابع

<?php echo Get_IMDBI('Action',poster_callback,callback) ;?>

نمایش عنوان

<?php echo 'عنوان: '.Get_IMDBI('Title') ;?>

نمایش پوستر اصلی

<?php echo Get_IMDBI('Poster') ;?>

نمایش پوستر اصلی (عدم نمایش خطای مربوطه)

<?php echo Get_IMDBI('Poster',True,False) ;?>

نمایش تصویر شاخص

<?php echo Get_IMDBI('Poster',False,False) ;?>

خروجی پارامتر پوستر به شکل زیر است

<img src="ادرس پوستر اصلی" alt="poster-عنوان فیلم|سال تولید">

به عنوان مثال خروجی پوستر فیلم true grit 1998 به شکل زیر است

<img src="http://nfqq.nvswi2lbfvuw2zdcfzrw63i.nblk.ru/images/M/MV5BMTYwNTE3NDYzOV5BMl5BanBnXkFtZTcwNTU5MzY0MQ@@._V1_SX300.jpg" alt="poster-true grit 1998">

پس شما نباید تابع را مجددا در یک تگ تصویر قرار دهید.(خروجی تصویر شاخص هم به همین صورت)

برای چاپ تابع حتما باید از دستور echo استفاده کنید.

فراموش نکنید در صورت فیلتر شدن آدرس پوستر، به صورت خودکار تصویر شاخص جایگزین می شود. پس برای هر پست یک تصویر شاخص در نظر بگیرید.

حق مالکیت و توسعه دهندگان

این افزونه یکی از پروژه های تیم اُپتیک است. نگارش فعلی متن باز بوده اما هنوز درباره نگارشات بعدی تصمیمی گرفته نشده است، لذا استفاده از سورس کد ها، ویرایش افزونه و بازنشر آن به شرط اشاره به سازندگان اصلی بلامانع است

اگر چنین شد، خوشحال میشم مارو در جریان قرار بدین info [at] opticteam [dot] net

کلام آخر

کلام آخر اینکه درسته نسخه پایدار این افزونه در اختیار شماست اما هنوز ممکنه باگ های ناشناخته ای توی افزونه پیدا بشه (که اونم اکثرا به خاطر تفاوت های ناچیز توی نگارش های وردپرس یا تنظیمات سایت شماست)

اگر راهکار جدیدی برای پیشرفت این افزونه در ذهن دارید، یا میتونید در توسعه اون ما رو یاری کنید. با من مکاتبه کنید mohammad.azami76 [at] gmail [dot] com

Donate To OMDB API (PayPall)