PHPackages jaroslawzielinski/torahverse-m2 - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. jaroslawzielinski/torahverse-m2 ActiveMagento2-module jaroslawzielinski/torahverse-m2 =============================== Torah verses (and quotes) slider 2.4.4(5mo ago)13811MITPHP Since Apr 6Pushed 5mo ago1 watchersCompare [ Source](https://github.com/JaroslawZielinski/TorahVerse-M2)[ Packagist](https://packagist.org/packages/jaroslawzielinski/torahverse-m2)[ Fund](https://www.buymeacoffee.com/jaroslawzielinski)[ RSS](/packages/jaroslawzielinski-torahverse-m2/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (2)Versions (68)Used By (0) TorahVerse-M2 ============= [](#torahverse-m2) A Magento2 module that provides dynamic Torah verse/quote sliders for both the backend (by default) and the frontend. Whether you're a store admin or a customer, you can enjoy these engaging, responsive sliders. The module calculates the available space and adjusts the number of words per line to optimize the display. If the text exceeds the configured row limit, the verse scrolls vertically, creating a seamless user experience. This ensures that the widget is **R**esponsive **W**eb **D**esigned and works beautifully on all devices. One of the most exciting aspects of this module is that it leverages the [Torah](https://github.com/JaroslawZielinski/Torah) library, a powerful API client with built-in caching (via SQLite). This PHP library pulls text from the [Bible Info](https://biblia.info.pl/) service, offering up to 21 different translations. For more details, feel free to check out the [repository](https://github.com/JaroslawZielinski/Torah). If you're excited about this project and want to support its ongoing development, consider buying me a coffee! Your support means a lot and helps keep this project alive. [!["Buy Me A Coffee"](https://camo.githubusercontent.com/9f44ce2dc3b3eecdd02598900866ffc518801df1932849703dae1e5ce5031070/68747470733a2f2f7777772e6275796d6561636f666665652e636f6d2f6173736574732f696d672f637573746f6d5f696d616765732f6f72616e67655f696d672e706e67)](https://www.buymeacoffee.com/jaroslawzielinski) New Features: ============= [](#new-features) Torah Input (frontend/backend) ------------------------------ [](#torah-input-frontendbackend) This UI component allows you to select any Bible verse from any translation, with a preview available in both the frontend and backend. Simply click the verse to navigate to the full passage on the Bible service. ### Frontend [](#frontend) Choose any Bible verse you like: [![](docs/torah_input_frontend.gif)](docs/torah_input_frontend.gif) ### Backend [](#backend) Easily edit the Bible verse reference directly in the form (just click *back* button): [![](docs/torah_input_backend.gif)](docs/torah_input_backend.gif) Torah Search ------------ [](#torah-search) Search feature helps you find what you are looking for in the Bible. There are several options for searching available. The results are presented with pagination. You may choose the page (next, previous) and set amount data visible on a single page. Note: Before using the search feature, you need to index your preferred Bible translations by running the following command: console command for f.e **bt**: ``` bin/magento torah:cache:flush bt && bin/magento torah:cache:warm bt ``` ### Searching options [](#searching-options) - **Search**: Enter the text you're looking for. - **Search in results**: Narrow down results with additional conditions. - **Search parts**: Filter by specific sections of the Torah (e.g., Tanakh, Nevi'im ketuvim, Brit Hadasha or Old Testamet, New Testament) - **Case-sensitive search**: Enable or disable case sensitivity. - **Verse context**: Choose to display surrounding verses for context. - **Translation**: Select one of 21 available translations. [![](docs/search.gif)](docs/search.gif) Torah Annuals Group ------------------- [](#torah-annuals-group) This feature allows you to display a specific quote on a given day of the year—perfect for creating a daily inspiration widget! You can set up 366 quotes, one for each day of the year. To create an annual quote: - Create a quote and fill in the required fields. - Assign it to an annual group. - Name (field *'Code'*) the quote using a special code that includes the date (last 4 characters represent the month and day, e.g., *'quote1024'* for October 24th). Installation Guide ================== [](#installation-guide) You can find the module on [Packagist](https://packagist.org/packages/jaroslawzielinski/torahverse-m2). To install: ``` cd YourProject composer require jaroslawzielinski/torahverse-m2 ``` Uninstallation ============== [](#uninstallation) To uninstall the module and revert all database changes, run the following command: ``` bin/magento torahverse:module:uninstall ``` Text Slider Features ==================== [](#text-slider-features) Backend Sliders --------------- [](#backend-sliders) The backend slider is visible only to Magento 2 users and supporters—customers won’t see this. Frontend Sliders ---------------- [](#frontend-sliders) For the frontend, you can choose between two slider types: 1. **Homepage Slider**: Display the slider on the homepage in 5 different placements: - After the header: `top.container` - At the top of the content: `content.top` - At the bottom of the content: `content.bottom` - Before the footer: `page.bottom` - Inside the footer: `footer`, `footer-container` 2. **Custom Sliders**: These can be placed anywhere on your site. Just create a slider and add it to any page, block, or widget using the Admin Panel. After defining custom slider with code f.e. 'annual\_quotes' (see [Slider Configurations](#slider-configurations)) you can use it within CMS Block/CMS Page: [![](docs/cms_content.gif)](docs/cms_content.gif) or create a CMS Widget: [![](docs/cms_widget.gif)](docs/cms_widget.gif) Slider Modes ------------ [](#slider-modes) ### Randomized Auto-Play Infinite Loop [](#randomized-auto-play-infinite-loop) Displays verses in a random order, continuously looping. ### Ordered Auto-Play Infinite Loop [](#ordered-auto-play-infinite-loop) Displays verses in the order they appear in the admin panel. ### Random Static View [](#random-static-view) Displays one random verse per page load. More Features ------------- [](#more-features) ### Pause Mode [](#pause-mode) Hover over the slider to pause the animation. ### Group Colors [](#group-colors) Display group names and colors for easy organization. Backend Features ================ [](#backend-features) First steps ----------- [](#first-steps) ### 1. Log in to the Admin Panel. [](#1-log-in-to-the-admin-panel) [![](docs/tv_slider_01.png)](docs/tv_slider_01.png) ### 2. Enable the module from the configuration menu. [](#2-enable-the-module-from-the-configuration-menu) [![](docs/tv_slider_02.png)](docs/tv_slider_02.png) [![](docs/tv_slider_03.png)](docs/tv_slider_03.png) 3. Add quotes and verses to different groups. --------------------------------------------- [](#3-add-quotes-and-verses-to-different-groups) ### Groups [](#groups) [![Groups grid](docs/tv_slider_07.png)](docs/tv_slider_07.png)Possible operations: **Add New Group**, **Delete**, **Edit** *Notice*: You can not modify/delete **Default Group**. [![Groups grid](docs/tv_slider_08.png)](docs/tv_slider_08.png) ### Groups/Verses [](#groupsverses) [![Verses grid](docs/tv_slider_09.png)](docs/tv_slider_09.png)Possible operations: **Add New Verse**, **Delete**, **Group Assign**, **Edit**[![Verses grid](docs/tv_slider_10.png)](docs/tv_slider_10.png) ### Groups/Quotes [](#groupsquotes) [![Quotes grid](docs/tv_slider_11.png)](docs/tv_slider_11.png)Possible operations: **Add New Quote**, **Delete**, **Group Assign**, **Edit**[![Quotes grid](docs/tv_slider_12.png)](docs/tv_slider_12.png) ### 4. Configure your sliders for the frontend and backend. [](#4-configure-your-sliders-for-the-frontend-and-backend) Configuration - Torah Verse =========================== [](#configuration---torah-verse) The module offers extensive customization options, from verse text colors to slide timing. Easily tweak your sliders to match your site’s style and layout. General Settings ---------------- [](#general-settings) ### Enable [](#enable) Enable module / Disable module and disable menu. ### Menu enabled [](#menu-enabled) Enables/disables menu in the left bar (and access to the grids) ### Service Link Enable [](#service-link-enable) This option allows to link to bible service on click (default is **on**) ### Sweep time [](#sweep-time) Time value in milliseconds between slides (horizontal swipe) ### Is vertical sweep possible [](#is-vertical-sweep-possible) Enables feature for vertical scroll (it is triggered when text exceeds ***'Number of shown rows'***) ### Vertical Sweep time [](#vertical-sweep-time) Time value in milliseconds between changing current shown row (during vertical scroll) ### Is group colours enable [](#is-group-colours-enable) Enables box with group title and group colour ### Html Template for Verse Slider Frame [](#html-template-for-verse-slider-frame) Provides html template for user tweaks. Available keys are listed in comment. - ***{url}*** - link for bible.info.pl service (target is "\_blank") - ***{textColour}*** - colour for verse text - ***{colour}*** - colour for group border/group label background - ***{groupName}*** - name of a group - ***{antiColour}*** - contrast colour to group border/group label background - ***{content}*** - verse content - ***{description}*** - verse description ### Html Template for Quote Slider Frame [](#html-template-for-quote-slider-frame) Provides html template for user tweaks. Available keys are listed in comment. - ***{textColour}*** - colour for quote text - ***{colour}*** - colour for group border/group label background - ***{groupName}*** - name of a group - ***{antiColour}*** - contrast colour to group border/group label background - ***{content}*** - quote content - ***{author}*** - quote author - ***{description}*** - quote description ### Html Template for Annual Slider Frame [](#html-template-for-annual-slider-frame) Provides html template for user tweaks. Available keys are listed in comment. - ***{textColour}*** - colour for quote text - ***{colour}*** - colour for group border/group label background - ***{groupName}*** - name of a group - ***{antiColour}*** - contrast colour to group border/group label background - ***{name}*** - quote name - ***{content}*** - quote content - ***{author}*** - quote author - ***{description}*** - quote description - ***{description2}*** - quote description2 - ***{description3}*** - quote description3 ### Verses ordered [](#verses-ordered) Enables numbering for verses or plain text mode. ### Text Colour [](#text-colour) Colour for text of sliders ### Background Hover Colour [](#background-hover-colour) Background colour when slider is being hovered/paused ### Mode of slider [](#mode-of-slider) Three modes for sliders are available: - ***'randomautoplayinf'*** - Randomized Auto play infinity loop - ***'autoplayinf'*** - Ordered Auto play infinity loop - ***'random'*** - Random view - static ### Number of shown rows [](#number-of-shown-rows) Number of shown rows (when 3 - default, please clear ***'Custom Styles'***) ### Custom Styles [](#custom-styles) Provides custom css styles (enables user tweaks (colour change, background, remove cursor etc.)) Admin Panel Slider ------------------ [](#admin-panel-slider) ### Enable [](#enable-1) enables/disables the feature. ### Override configuration [](#override-configuration) You may override following settings (from **General Settings**): - **Sweep time** - **Is vertical sweep possible** - **Vertical Sweep time** - **Is group colours enable** - **Verses ordered** - **Text Colour** - **Mode of slider** ### Slider Configuration [](#slider-configuration) In this multi select you may choose groups that you would like to display. Homepage Slider --------------- [](#homepage-slider) ### Enable [](#enable-2) enables/disables the feature. ### Override configuration [](#override-configuration-1) You may override following settings (from **General Settings**): - **Sweep time** - **Is vertical sweep possible** - **Vertical Sweep time** - **Is group colours enable** - **Verses ordered** - **Text Colour** - **Mode of slider** ### Placement of a slider [](#placement-of-a-slider) There are 5 available placements (**Magento2** container name in layout): - ***'top.container'*** - After page header top - ***'content.top'*** - Main content top - ***'content.bottom'*** - Main content bottom - ***'page.bottom'*** - Before page footer - ***'footer'*** - Page footer', - ***'footer-container'*** - Page Footer Container ### Slider Configuration [](#slider-configuration-1) In this multi select you may choose groups that you would like to display. Custom Sliders -------------- [](#custom-sliders) ### Enable [](#enable-3) enables/disables the feature. ### Override configuration [](#override-configuration-2) You may override following settings (from **General Settings**): - **Sweep time** - **Is vertical sweep possible** - **Vertical Sweep time** - **Is group colours enable** - **Verses ordered** - **Text Colour** - **Mode of slider** ### Slider Configurations [](#slider-configurations) Array for sliders (code, slider configuration). You may add/edit/delete as many configurations as you want. [![Groups grid](docs/tv_slider_13.png)](docs/tv_slider_13.png) Configuration - Torah ===================== [](#configuration---torah) Language Settings ----------------- [](#language-settings) ### Language [](#language) You have two available languages: English and Polish. This settings changes the language of description in Torah siglum. ### Translate Preset [](#translate-preset) You may also update Groups/Verses/Quotes Presets in given language version. Remember to Save before clicking the button unless you prefer the language written in button's label. [![Groups grid](docs/tv_slider_14.png)](docs/tv_slider_14.png) Torah Input ----------- [](#torah-input) ### Division [](#division) You may choose division of books in Torah Input (e.g. **Old Testament\\New Testament**). Default value is **Tanakh/Nevi'im ketuvim/Brithadasha**. This feature will be used in the future. ### Bible Tools enabled [](#bible-tools-enabled) Default value is **No**. If set to **Yes** it appears in menu in **Bible Tools** group as **Verse Config** where **Verse Pick** and **Verse Search** are presented. In the future the input will be customized (you will choose all the options by just clicking it, without typing anything). The Torah input is also used in Admin Panel in Verse Grid (*Add New Verse/Edit* action) [![Groups grid](docs/tv_slider_15.png)](docs/tv_slider_15.png) after clicking, it will be opened in new tab (notice little square put next to the link) as a front page: [![Groups grid](docs/tv_slider_17.gif)](docs/tv_slider_17.gif) ### Case Sensitive [](#case-sensitive) Default Option for **V**erse **S**earch form. ### Division parts filter [](#division-parts-filter) Default Option for **V**erse **S**earch form. ### Results per page [](#results-per-page) Default Option for **V**erse **S**earch form. Library Settings ---------------- [](#library-settings) ### Cache Enable [](#cache-enable) This option enables/disable API caching for Bible Service. Down bellow there are serveral indicators for Bible Translations Cache state. **100%** means the cache is warmed and all of the bible verses are stored in local DB (sqllite). **V**erse **S**earch will be possible for cached Translation. **0%** means the cache is not ready. You can not use the **V**erse **S**earch for the translation then. [![](docs/tv_slider_18.png)](docs/tv_slider_18.png) Frontend ======== [](#frontend-1) Example uses ------------ [](#example-uses) [![Groups grid](docs/tv_slider_04.png)](docs/tv_slider_04.png) Pause mode (cursor changes, and background) ------------------------------------------- [](#pause-mode-cursor-changes-and-background) [![Groups grid](docs/tv_slider_05.png)](docs/tv_slider_05.png)*Notice*: You can configure it in **Background Hover Colour**, **Custom Styles** configuration options. Group Colours enabled --------------------- [](#group-colours-enabled) [![Groups grid](docs/tv_slider_06.png)](docs/tv_slider_06.png) See also ======== [](#see-also) - [Groups/Verses/Quotes Presets (EN)](GROUPS_en.md) - [Groups/Verses/Quotes Presets (PL)](GROUPS_pl.md) - [Torah github](https://github.com/JaroslawZielinski/Torah) Inspiration for vertical scroll =============================== [](#inspiration-for-vertical-scroll) - [Truthunedited](https://www.youtube.com/@Truthunedited) - presenting Torah verses Explore these features, play with the settings, and see how this module can elevate your **Magento2** site! And if you find value in this, I'd greatly appreciate your support on [**Buy Me a Coffee**](https://www.buymeacoffee.com/jaroslawzielinski) — it helps keep projects like this alive. [!["Buy Me A Coffee"](https://camo.githubusercontent.com/9f44ce2dc3b3eecdd02598900866ffc518801df1932849703dae1e5ce5031070/68747470733a2f2f7777772e6275796d6561636f666665652e636f6d2f6173736574732f696d672f637573746f6d5f696d616765732f6f72616e67655f696d672e706e67)](https://www.buymeacoffee.com/jaroslawzielinski) ### Health Score 41 — FairBetter than 89% of packages Maintenance71 Regular maintenance activity Popularity15 Limited adoption so far Community5 Small or concentrated contributor base Maturity59 Maturing project, gaining track record How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~14 days Recently: every ~30 days Total 67 Last Release 163d ago Major Versions 1.2.11 → 2.0.02024-08-16 ### Community Maintainers ![](https://www.gravatar.com/avatar/b9dacae85b305ffeca25fcb76b407d44db1b6ba35e3ae6ac9ce595ae0753a74d?d=identicon)[JaroslawZielinski](/maintainers/JaroslawZielinski) --- Tags biblebible-quotebible-versebible-versesmagento2quotestext-slidertorahversevertical-scrolling ### Embed Badge ![Health badge](/badges/jaroslawzielinski-torahverse-m2/health.svg) ``` [![Health](https://phpackages.com/badges/jaroslawzielinski-torahverse-m2/health.svg)](https://phpackages.com/packages/jaroslawzielinski-torahverse-m2) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)