برنامه نویسی

اعلام Zmanim WP: افزونه جدید وردپرس من

پیشنهاد زمان محدود! من برای ماجراجویی بعدی خود به عنوان یک مدافع Devrel / Evangelist فنی / Talespinner IT آماده هستم. اگر این به نظر می رسد مانند چیزی که شما نیاز دارید ، یک خط را از طریق ایمیل یا LinkedIn برای من رها کنید

اگر این وبلاگ را دنبال کرده اید ، می دانید که من یک سری در حال اجرا در زمینه اجرای PHP ZMANIM ، کتابخانه بر اساس کوشر جاوا داشتم که کار مورد نیاز برای محاسبه زمان مربوط به مشاهدات مذهبی یهودی را ساده می کند. (اگر به توضیحات کاملی در مورد آنچه که در آن است نیاز دارید ، اولین وبلاگ این سریال را بررسی کنید.)

در حالی که کار درک و اجرای PHP Zmanim به خاطر خود سرگرم کننده بوده است ، من در حال کار بر روی یک هدف بزرگتر در پشت صحنه بودم: یک افزونه وردپرس که این کتابخانه را به گونه ای اجرا می کرد که غیر برنامه ریزان می توانند در وب سایت های خود (مبتنی بر وردپرس) استفاده کنند.

امروز ، من از اعلام این افزونه برای بارگیری در دسترس است. همسرم به همان اندازه هیجان زده است زیرا این بدان معنی است که من (امیدوارم) به طور مداوم به یاد می آورم که بخاطر غذا خوردن ، حمام کردن و آمدن به رختخواب.

Zmanim WP رایگان است* و می تواند از داخل محیط وردپرس خود بارگیری شود (به افزونه ها بروید ، یک افزونه جدید اضافه کنید و “Zmanim WP” یا حتی فقط “Zmanim” را جستجو کنید).

مانند فیلم آینده “The Thunderbolts*” ، Splat (یا “ستاره” برای جوانان و زبان شناسان پدیده) کمی بلند کردن سنگین را انجام می دهد. Zmanim WP در واقع “freemium” است ، به این معنی که برخی از ویژگی ها برای شما برای همیشه در دسترس شما هستند و سایر قابلیت ها فقط در صورت خرید مجوز باز است.

قبل از اینکه مشعل ها را آتش بزنید ، پیست های ضد سرمایه داری را بگیرید و به عمارت مجلل من در کلیولند با آتش سوزی در قلب خود بروید ، توجه داشته باشید که تمام درآمد حاصل از آن به امور خیریه می رود. موسسه خیریه اولیه کنیسه من خواهد بود زیرا:

  1. خاخام پسر عموی من است و او یک پسر شگفت انگیز است … اما مهمتر از همه ،
  2. آنها بیش از 2 سال است که آلفا را آزمایش کرده اند و مجبور بودند تمام شروع های دروغین ، اشتباهات ، محاسبات زمان بد و سؤالات من را متحمل شوند. و این کار را با صبر ، تعادل و طنز خوب انجام داد.

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

چگونه Zmanim WP کار می کند

در ساده ترین شکل خود ، استفاده روزانه (من در یک دقیقه به تنظیم اولیه می رسم) این افزونه شامل کد کوتاه است ، که ممکن است به این شکل باشد:

[zman_sunset]
حالت تمام صفحه را وارد کنید

از حالت تمام صفحه خارج شوید

یا

[zman_shema]
حالت تمام صفحه را وارد کنید

از حالت تمام صفحه خارج شوید

یا

[zman_misheyakir]
حالت تمام صفحه را وارد کنید

از حالت تمام صفحه خارج شوید

اساساً این مجموعه ای از براکت ها است ([...]) با کلمه “ZMAN_” که به دنبال آن نوع خاصی از زمان است. هنگامی که یک بازدید کننده به وب سایت زنده (مبتنی بر وردپرس) می آید و صفحه ، پست یا ویجت را با آن کد کوتاه مشاهده می کند ، زمان مربوطه را نشان می دهد.

به عنوان مثال ، من آن را در این وب سایت در حال اجرا هستم ، با مکانی که در دیزنی لند در کالیفرنیا قرار دارد (LAT: 33.8120918 ، طولانی: -117.9215545). با استفاده از کد کوتاه [ zman_sunset ] غروب امروز را برای آن مکان مشاهده خواهید کرد ، مهم نیست که در کدام روز این صفحه را مشاهده می کنید: 5:49 بعد از ظهربشر

اگر گزینه های دیگری را درج نکنید ، زمان روز جاری را در یک استاندارد نشان می دهد _hh:mm am/pm_ قالب

اما واقعیت این است که شما می توانید گزینه ها را درج کنید – بسیاری از آنها. به عنوان مثال (و این فقط یک نمونه است. برای لیست کامل گزینه ها باید مستندات Zmanim WP را در adatosystems.com بررسی کنید) می توانید یک گزینه تاریخ را درج کنید

  • “فردا” روز بعد از مشاهده صفحه را نشان می دهد.
    • [ zman_alot date="tomorrow" ] (که دوباره برای “شادترین مکان روی زمین” تنظیم شده است 4:17 صبح)
  • “یکشنبه” (یا دوشنبه ، سه شنبه و غیره) روز آینده بعدی این نام را نشان می دهد. بنابراین اگر در حال حاضر دوشنبه است ، کد زیر غروب خورشید را برای چهارشنبه آینده نشان می دهد:
    • [ zman_sunset date="Wednesday" ] (که نتیجه 5:51 بعد از ظهر است)
  • (یک تاریخ واقعی) زمان تاریخ مشخص شده را نشان می دهد.
    • [ zman_alot date="2025-01-10" ] (که به شما 4:57 صبح می دهد)

همچنین می توانید یک جبران زمان را نیز درج کنید. بیایید بگوییم که Mincha هر روز 20 دقیقه قبل از غروب آفتاب شروع می شود. شما می توانید به طور خودکار آن زمان را با استفاده از کد نمایش دهید:

[ zman_sunset offset=-20 ] (نتیجه 5:29 بعد از ظهر)

همچنین می توانید قالب بندی زمان را تغییر دهید. این امر کمی بیشتر به علفهای هرز می رسد ، زیرا از قالب بندی DateTime داخلی PHP استفاده می کند (در اینجا یک آموزش خوب در مورد نحوه کار این کدهای قالب بندی وجود دارد.). بنابراین ، اگر می خواستم اطلاعات تاریخ را به همراه زمان (از جمله ثانیه) برای غروب خورشید بدست آورم ، می توانم از این استفاده کنم:

[ zman_sunset dateformat="m-d-Y h:i:s a" ] (این خواهد بود: 03-02-2025 05:49:24 PM)

و فقط برای اینکه در مورد چیزها کاملاً واضح باشید ، در صورت تمایل می توانید از همه آن کدها استفاده کنید.

همچنین برخی از گزینه ها وجود دارد که در سراسر صفحه کار نمی کند. به عنوان مثال “لنگ” به شما امکان می دهد عبری یا انگلیسی را برای برخی از خروجی ها مانند بخش تورات یا تاریخ مشخص کنید. اما این برای غروب آفتاب کار نمی کند.

پاییز: راه اندازی Zmanim WP

من گفتم که به این قسمت می رسم. صادقانه بگویم ، تنظیم همه چیز درگیر نیست. پس از نصب افزونه ، یک منوی جدید در پورتال Admin WordPress دریافت خواهید کرد. با کلیک بر روی منوی سطح بالا ، شما را به صفحه اصلی گزینه ها می برد:

گزینه های اصلی Zmanim WordPress

در اینجا مکان (با استفاده از عرض جغرافیایی و طول جغرافیایی) ، منطقه زمانی و چند عنصر آرایشی دیگر را تنظیم می کنید.

با این حال ، کار اصلی پیکربندی در صفحه تنظیمات استاندارد Zmanim اتفاق می افتد.

گزینه های زمان استاندارد

این جایی است که شما روش محاسبه هر ZMAN را از کشویی که با طیف گسترده ای از عقاید حلقوی جمع شده است ، انتخاب می کنید.

ویژگی های رایگان

کد کوتاه که در دسترس همه کاربران است عبارتند از:

مکان و مرجع

  • Zman_Location – همانطور که در صفحه مدیر تعریف شده است ، مکان را نمایش می دهد.
  • ZMAN_LAT – همانطور که در صفحه سرپرست تعریف شده است ، عرض جغرافیایی را نشان می دهد.
  • ZMAN_LONG – طول جغرافیایی را نشان می دهد ، همانطور که در صفحه مدیر تعریف شده است.
  • ZMAN_TZONE – منطقه زمانی را نشان می دهد ، همانطور که در صفحه مدیر تعریف شده است.
  • تاریخ ها و روزهای خاص
  • ZMAN_SHAAH-یک ساعت حلشی ، یا 1/12 از نور روز موجود ، همانطور که بر اساس شیتا انتخاب شده در کشویی در صفحه مدیر محاسبه می شود.
  • zman_parsha – خواندن تورات را برای آن هفته فراهم می کند
  • zman_zmandate – تاریخ را ارائه می دهد
  • ZMAN_CHODESH – روز (ها) برای Rosh Chodesh مشخص شده. اگر تاریخ ذکر شده “امروز” یا “بعدی” باشد ، اگر این هفته/هفته آینده راش چودش باشد ، متن قابل مشاهده است.
  • ZMAN_MOLAD – روز/زمان برای مولد مشخص شده. اگر تاریخ مشخص شده “امروز” یا “بعدی” باشد ، اگر این هفته/هفته آینده مولد باشد ، متن فقط قابل مشاهده است.

استاندارد من مدیریت می کنم

  • ZMAN_SUNRISE – Netz Hachachma (طلوع آفتاب ، بدون ارتفاع).
  • Zman_sunset – Shkia (غروب خورشید دریایی ، بدون ارتفاع).
  • ZMAN_CANDLES – زمان شمع Shabbat ، که Sunset/Shkia منهای تعداد دقیقه های ذکر شده در صفحه مدیر است.
  • ZMAN_ALOT – بسیار هاشاچار (اولین زمان برای Tallit & Tefillin).
  • Zman_Misheyakir – Misheyakir (اولین زمان برای Tefillot).
  • rman_shema – کشتی Criath Right Right (آخرین زمان برای گفتن SHEM)
  • ZMAN_TEFILLA – SOF ZMAN TEFILLA (آخرین زمان برای گفتن Shacharit)
  • Zman_gedola – Mincha Gedola
  • Zman_Ketana – Mincha Ketana
  • Zman_Plag – Plag Hamincha
  • ZMAN_BAIN – B'ain Hashmashot (زمان بین غروب خورشید/Shkia و Tzeit Hakochavim).
  • ZMAN_TZAIT – TZAIT HAKOCHAVIM (زمان 3 ستاره در آسمان شب قابل مشاهده است).

ویژگی های پرداخت شده

کد کوتاه زیر فقط در نسخه پرداخت شده افزونه Zmanim WP موجود است. همراه با کد کوتاه که در زیر مشاهده می کنید ، صفحه های پیکربندی اضافی برای تنظیم گزینه ها و عناصر کلیدی کدها وجود دارد.

  • ZMAN_EARLYSHKIA -اولین زمان Shkia را برای هفته (یکشنبه -پنجشنبه) که در آن تاریخ ارائه شده رخ می دهد ، نمایش می دهد.
    • مثال 1: اولین Shkia را برای این هفته نمایش دهید:
    • مثال 2: اولین Shkia را برای هفته آینده نمایش دهید:
  • ZMAN_LATESHKIA – آخرین زمان Shkia را برای هفته (یکشنبه – پنجشنبه) نشان می دهد که در آن تاریخ ارائه شده داده شده است
  • zman_lyear* – همانطور که در بخش “نمایش کامل سال” در بالا توضیح داده شده است ، این یک شبکه از زمانها را برای یک سال کامل نشان می دهد.
  • zman_early_shabbat_1* از طریق zman_early_shabbat_4* – همانطور که در بخش “گزینه های اولیه shabbat” در بالا توضیح داده شده است ، هر یک از اینها یکی از دو خروجی کد کوتاه را برای shabbat زودرس/منظم نشان می دهد.
  • zman_misheyakirweekly – برای این هفته یا هفته آینده ، بارها و بارها برای میشیاکیر فراهم کنید. با استفاده از گزینه “Daynum” به زمان های خاص دسترسی پیدا می کند.

آخرین کلمه (در حال حاضر)

با بازگشت به اولین پست “سری داده های زمانی” من:

“این هفته نماز بعد از ظهر (مینچا) چه ساعتی خواهد بود؟” یک سؤال فریبنده پیچیده است. این فریبنده است زیرا به نظر می رسد “نماز بعد از ظهر” خود توضیحی است ، اما (مانند بسیاری از موارد مربوط به قوانین مذهبی یهودی (Halacha) پیشینه ، تفسیر و ویژگی های زیادی وجود دارد.

اگر پاسخ به این سؤال شما را محکم کرده باشد ، افزونه Zmanim WP فقط می تواند کمک کند. برای اطلاعات بیشتر ، از جمله نحوه بارگیری ، نصب و به روزرسانی به نسخه پرداخت شده افزونه ، مستندات Zmanim WP را در adatosystems.com بررسی کنید

نوشته های مشابه

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

دکمه بازگشت به بالا