پیش نمایش جادوگر

جادوگر پیش نمایش به گونه ای طراحی شده است که به شما امکان می دهد پیش نمایش ها را سریع، آسان و قابل اعتماد با سایت خود ادغام کنید. شما می توانید یک نمایشگر کتاب جاسازی کنید، به جستجوی کتاب پیوند دهید، یا حتی یک پنجره "پاپ آپ" پیش نمایش را به سایت خود اضافه کنید - تنها کاری که باید انجام دهید این است که کد را ایجاد کرده و آن را در صفحه خود بچسبانید. همچنین می توانید این کد را با استفاده از برخی از توابع ساده جاوا اسکریپت سفارشی کنید.


جادوگر پیش‌نمایش یک کتابخانه ساده است که ما بر روی پیوندهای پویا و APIهای نمایشگر جاسازی شده خود ساخته‌ایم. اگر توسعه‌دهنده‌ای هستید که به دنبال یکپارچه‌سازی سفارشی‌شده هستید، مستقیماً از APIهای زیربنایی استفاده کنید.

کد پیش نمایش خود را ایجاد کنید

نمونه هایی از پیش نمایش های تولید شده

نمونه‌های زیر با استفاده از پیش‌نمایش ویزارد تولید شده‌اند.

  • previewwizard-embed : بیننده کتاب را در صفحه جاسازی می کند.
  • previewwizard-popup : دکمه ای را اضافه می کند که می توان روی آن کلیک کرد تا یک پیش نمایش شناور در صفحه باز شود.
  • previewwizard-linktogbs : دکمه ای را وارد می کند که به پیش نمایش در سایت جستجوی کتاب پیوند می دهد.
  • previewwizard-customurl : دکمه ای را نشان می دهد که به یک URL خاص می رود.

کد خود را سفارشی کنید

علاوه بر استفاده از جادوگر بالا، می‌توانید مستقیماً برخی از توابع ساده جاوا اسکریپت "Helper" را فراخوانی کنید. برای انجام این کار، ابتدا باید کتابخانه Preview Wizard را بارگذاری کنید. یکی از راه های انجام این کار این است که تگ زیر را به بخش <head> صفحه خود اضافه کنید:

<script type="text/javascript" src="https://books.google.com/books/previewlib.js"></script>

پس از بارگیری کتابخانه پیش‌نمایش، می‌توانید هر یک از توابع زیر را از درون تگ‌های <script> داخل <body> سند خود فراخوانی کنید. به عنوان مثال، اگر می‌خواهید دکمه «پیش‌نمایش Google» را وارد کنید، کدی را برای این کار در عنصر <script> در موقعیت دلخواه دکمه در صفحه قرار دهید.

GBS_setLanguage

GBS_setLanguage(languageCode)
    زبان هر دکمه یا متنی را که پس از فراخوانی این تابع اضافه می شود، تغییر می دهد. این شامل زبان دکمه «پیش‌نمایش Google»، زبان رابط پیش‌نمایش تعبیه‌شده و غیره است.
    مولفه های:
      string languageCode - کد زبان RFC 3066 مورد نظر (پیش‌فرض برای انگلیسی 'en' است). کدهای زبانی که در حال حاضر پشتیبانی می شوند عبارتند از: hy, bg, ca, zh-CN, zh-TW, hr, cs, da, nl, en, fil, fi, fr, de, el, hi, hu, is, id, in, it , ja, ko, lv, lt, no, pl, pt-BR, pt-PT, ro, ru, sr, sk, sl, es, sv, th, tr, uk, و vi.

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    مولفه های:
      Object optionsObj - مجموعه ای از جفت های کلید-مقدار به سازنده DefaultViewer API Embedded Viewer ارسال می شود. به طور معمول، این برای سفارشی سازی های پیشرفته استفاده می شود.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    این عملکرد که برای استفاده توسط ناشران در برنامه شریک در نظر گرفته شده است، سایت جستجوی نام تجاری مشترک را تنظیم می کند تا هنگام درج پیوندهای پیش نمایش به جستجوی کتاب استفاده شود. فراخوانی این عملکرد قبل از قرار دادن دکمه تضمین می کند که کاربران آرم شریک را در بالای پیش نمایش های جستجوی کتاب می بینند.
    مولفه های:
      string cobrandName - نام cobrand که باید به هر URL جستجوی کتاب اضافه شود. این معمولاً پس از /p/ در URLهای پیش‌نمایش جستجوی Co-Branded موجود است.

      به عنوان مثال، تنظیم مقدار به sup ، کاربر را به پیوندهایی مانند
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      به جای پیش فرض
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    هر جا که این تابع فراخوانی شود، پیش‌نمایش کتاب تعبیه‌شده را درج می‌کند. اگر پیش نمایش در دسترس نباشد، هیچ بیننده ای نشان داده نمی شود.
    مولفه های:
      Number opt_width - عرض مورد نظر بیننده، بر حسب پیکسل.
      Number opt_height - ارتفاع مورد نظر بیننده، بر حسب پیکسل.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    اگر پیش‌نمایش کتاب در دسترس باشد، این عملکرد دکمه «پیش‌نمایش Google» را می‌نویسد. با کلیک بر روی این دکمه یک "پنجره پیش نمایش شناور" درست در بالای صفحه شما باز می شود. اگر پیش‌نمایش در دسترس نباشد، دکمه کشیده نمی‌شود.

    ممکن است برنامه‌نویسان پیچیده‌تر به Embedded Viewer API علاقه‌مند باشند، که این تابع به صورت داخلی از آن استفاده می‌کند.

    مولفه های:
      string, Array identifier - URL پیش نمایش یا شناسه کتاب مانند شماره ISBN، OCLC یا LCCN. قالب درخواست پیوندهای پویا را ببینید. اگر چندین شناسه جایگزین برای کتاب می‌شناسید، می‌توانید آرایه‌ای از این شناسه‌ها را ارسال کنید و اگر پیش‌نمایش برای هر یک از آنها در دسترس باشد، دکمه ظاهر می‌شود. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    اگر پیش‌نمایش کتاب در دسترس باشد، این عملکرد دکمه «پیش‌نمایش Google» را می‌نویسد که به سادگی به صفحه پیش‌نمایش کتاب پیوند می‌خورد. به‌طور پیش‌فرض، این به پیش‌نمایش در Google Books پیوند دارد، اما همچنین می‌توانید:
    • به یک URL در سایت خود پیوند دهید (که باید به نوبه خود حاوی یک نمایشگر تعبیه شده باشد). شما می توانید این کار را با عبور از گزینه optional alternativeUrl انجام دهید.
    • اگر GBS_setCobrandName قبل از این تابع فراخوانی شده باشد، به نسخه Co-Branded صفحه پیش نمایش کتاب پیوند دهید.
    اگر هیچ پیش نمایشی در دسترس کاربر نباشد، دکمه ای روی صفحه کشیده نمی شود.
    مولفه های:
      string, Array identifier - URL پیش نمایش یا شناسه کتاب مانند شماره ISBN، OCLC یا LCCN. قالب درخواست پیوندهای پویا را ببینید. اگر چندین شناسه جایگزین برای کتاب می‌شناسید، می‌توانید آرایه‌ای از این شناسه‌ها را ارسال کنید و اگر پیش‌نمایش برای هر یک از آنها در دسترس باشد، دکمه ظاهر می‌شود.
      Object opt_options - اختیاری - نقشه نام-مقدار مورد استفاده برای پیکربندی رفتار دکمه. در حال حاضر یک گزینه پشتیبانی می شود: alternativeUrl . به عنوان مثال، برای اینکه دکمه پیش‌نمایش Google به یک صفحه پیش‌نمایش سفارشی در سایت خود پیوند داشته باشد، کافی است موارد زیر را به عنوان آرگومان دوم به GBS_insertPreviewButtonLink :
      { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }