XF 2.1 / 2.2 / 2.3 Standard Library by Xon 1.22.6

laurent68 · 6 Juin 2025

Required for all XF2.1+ compatible add-ons.

A number of helper utilities designed to ease add-on development, does not have any direct user-facing changes.
Uploaded to aid dependency tracking and allow updating without updating every individual add-on.

Télécharger V1.0.0 :

Version 1.1.0 - Feature update, breaking change with some older add-ons

Add "replacevalue" templete filter used in a number of add-ons for implementing multi-select filter support
Add php 7 type hinting to various methods. Warning: this is a breaking change which cause site-disabling errors with older versions of the following add-ons;
Optimized List Queries v2.4.0 or earlier (free add-on)
Multi Prefix v2.7.5 or earlier (paid add-on)
Conversation Essentials v2.3.18 or earlier (paid add-on)
Bookmark Essentials v3.0.9 or earlier (paid add-on)
Tag Essentials v2.2.1 or earlier (paid add-on)
Additional 3rd party add-ons may have conflicts, and they will require updating or rolling back this add-on. This add-on is a drop-in replacement after updating the namespace being imported

Version 1.1.1 - Bugfix update : Fix typo in function name causing a templater error.

Télécharger V1.1.1 :

Version 1.1.2 Bugfix update :

When the installer is renaming things (phrases/options/etc), disable development file output as it can cause unexpected upgrade failures when the board is in dev mode.

Télécharger V1.1.2 :

Version 1.2.0 change : Add helper method for generating alias'ed classes to correctly support resolveExtendedClassToRoot function (used in controllers & entities)

Version 1.2.1 Bugfx update :

Add templater function which can reverse array/array collection
Fix possible MySQL 8.0+ collation error in renamePhrases

Télécharger V1.2.1 :

Version 1.3.0 Feature update :

Implement a custom date/time picker, with a custom input filter. Replacement for pikaday in XF2.2 no longer supporting a time component. Supports seconds (opt-out), and explicit time-zone selection.

XML:

<xf:macro template="svStandardLib_helper_macros" name="date_time_input" arg-name="startTime" arg-timestamp="{$xf.time}" />

XML:

<xf:macro template="svStandardLib_helper_macros" name="date_time_input_row" arg-label="{{ phrase('start_time') }}" arg-name="startTime" arg-timestamp="{$xf.time}" />

PHP:

$timestamp = $this->filter('startTime', 'sv-datetime');

Version 1.3.1 Bugfix update : Fix custom date/time picker incorrectly setting the 'day' component of a date to the 'year' value.

Télécharger V1.3.1 :

Version 1.4.0 - Feature update :

Bundle moment.js 2.29.1
Extract count down/up timer html/javascript from Vote Tally & Notice Time Replacables add-ons, this includes singular time.<part> phrases.

Example usage (generates html & loads javascript) ;

PHP:

$func = \XF::$versionId >= 2010370 ? 'func' : 'fn';
return $this->app->templater()->$func('sv_relative_timestamp', [
    $now->getTimestamp(), $other->getTimestamp(), // now and other date time obj
    0, $countUp, // maximum date parts and if allowed counting up
    'time-notice', // class added to the span
    'click', '< .notice-content | .notice-dismiss' // event to trigger and who trigger it on
]);

Télécharger V1.4.0 :

Version 1.4.1 - Maintenance update :

Ensure time counter timer doesn't cause unneeded HTML updates
When time counter code has maximum date parts set, do not append smaller units. ie "30 days 10 minutes" should be "30 days"

Télécharger V1.4.1 :

Version 1.5.0 - Admin Feature update

Add "View template modifications" when viewing a template with template modifications that apply.
A powerful diagnostic tool when diagnosing add-on conflicts in production!
Lists all modifications that are applying, and allows on-the-fly which are applying or not to view different permutations.
Allows viewing compiled template code various template modifications, extremely useful for isolating exactly where in a highly modified template is actually causing errors.
Note; viewing compiled template code dynamically compiles the selected template & modifications and does not read the actual on-disk representation.
If xdebug is active, this can be very slow !

Télécharger V1.5.0 :

Version 1.5.1 Maintainance update : Add "Compiler errors" missing phrase. Thanks @TickTackk

Télécharger V1.5.1 :

Version 1.5.2 Bugfix/Maintenance update : Improve installer helper addOrChangeColumn to be rename-aware to avoid generating invalid SQL

Télécharger V1.5.2 :

Version 1.5.3 - Bugfix update :

Restore php 7.0 compatibility
Fix "renamePhrases" install helper ignoring 3rd argument "replace"

Télécharger V1.5.3 :

Version 1.5.4 - Bugfix update : Fix minute value in time-selector not round-tripping as expected

Télécharger V1.5.4 :

Version 1.6.0 - Feature update :

Document features in Xon/XenForo2-StandardLib
Extend XF.Tabs to store the ID of the selected tab on submit via a hidden field.
Field name is set via data-sv-store-selected-tab-input-name added to the data-xf-init="tabs" element

HTML:

<xf:js addon="SV/StandardLib" src="sv/lib/xf/core/structure.js" min="1" />
...
<div class="hScroller"
     data-xf-init="h-scroller tabs"
     data-panes=".js-categoryTypeTabPanes"
     data-sv-store-selected-tab-input-name="category_type">

Télécharger V1.6.0 :

Version 1.7.0 - Feature update

Force global namespace for functions which are known to be optimizable to bytecode in php
Add hook-point for more aggressively rewrite inner-sub-query on early joins

Version 1.7.1 - Bugfix update

Fix out-of-memory error if multiple add-ons use EarlyJoinFinderTrait on the same class.
If using Optimized list queries add-on (free), this is a required update

Version 1.7.1 Patch 1

Rebuild redistributable to exclude incorrectly included bad class extension.
The 1.7.1 zip breaks the upload zip functionality! To recover;
Disable the Standard Library by Xon add-on.
Update the add-on
Ensure the Standard Library by Xon add-on is enabled

Télécharger V1.7.0 Patch 1 :

Version 1.7.2 - Maintenance update : Update EarlyJoinFinderTrait to send additional arguments to the getEarlyJoinThreshold method, this is a non-breaking change

Télécharger V1.7.2 :

Version 1.7.3 - Bugfix update :

Add sanity check for add-ons with composer during add-on install
In XF2.2+, fix pikaday css not being loaded when using extended day-time picker
Impacted addons; Advanced Bb-Code Pack (Time bb-code), Live Content, Vote tally.

Télécharger V1.7.3 :

Version 1.8.0 - Feature update :

When viewing a template, always show the 'view template modifications' link to allow viewing compiled code
Add an addValue template filter, to complement removeValue filter, and related phrases

Télécharger V1.8.0 :

Version 1.8.1 : Fix "DevTools failed to load source map: Could not load content for .../js/sv/vendor/moment/moment.min.js.map"

Télécharger V1.8.1 :

Version 1.8.2 - Bugfix update : Fix triggering an error on /forums/1/page-9223372036854775807 when Optimized Query List add-on is used and php7+ type hinting is used.

Télécharger V1.8.2 :

Version 1.9.0 - Maintenance update :

Fix 32bit support when detecting early-join behaviour (ie Optimize List Queries add-on)
Move helper features for extending forum/prefix filters into Standard Lib from a number of other add-ons

Télécharger V1.9.0 :

Version 1.10.0 - Feature update :

Update EarlyJoinFinderTrait to add support tables with compound primary keys
Document using InstallerHelper
Add InstallerHelper::getReversedAlterTables (with example usage in README.md), to hopefully simplify uninstaller code.
Takes the result of getAlterTables (array of table alters) and reverses simple column adds, renames and index adds.

Version 1.10.2 - Bugfix update :

Fix for using SqlJoinTrait and EarlyJoinFinderTrait together
Resolves compatibility issue when using Bump Thread and Optimized List Queries add-ons together

Télécharger V1.10.2 :

Version 1.11.1 - Feature update :

Remove outdated comment in EarlyJoinFinderTrait
Add isPermissionInUse install helper
Add SV\StandardLib\Behavior\Cacheable behavior, to help automate calling rebuildCache (or a defined function) on a repository which matches the entity's name
Use templater_setup code event to inject various filters/functions into multiple templater types.
Adds the extendable class SV\StandardLib\TemplaterHelper to help add filters/functions to templates without manualy extending every templater type
Add new template filters/functions
parse_less_func
abs
array_diff
sv_array_reverse => array_reverse
Backport phrase_dynamic function to XF2.1

Télécharger V1.11.1 :

Version 1.11.2 Bugfix update : Fix type-error when a collection is passed to the removeValue templater filter function.

Télécharger V1.11.2 :

Version 1.12.0 - Feature update :

Move quick_filter template/js which dynamically updates body/pagenav in an overlay from SV/WhoReplied into SV/StandardLib
See Who Replied v2.2.0+ or User Mention Improvements v2.8.0+ for examples of usage

Télécharger V1.12.0 :

Version 1.12.1 - Bugfix update : XF2.2.10 compat fix for "view template modifications" link not rendering.

Télécharger V1.12.1 :

Version 1.12.2 - Maintenance update : Avoid duplicate some join expressions multiple times when using optimized list query add-on.

Télécharger V1.12.2 :

Version 1.13.0 :

Add is_toggle_set template function and toggle-storage-ex backend for the XF toggle JS.
The stock is_toggled does not allow setting the default value, while is_toggle_set does.
Example of a default collapsed node-list :

PHP:

<xf:js src="sv/lib/storage.js" addon="SV/StandardLib" min="1" />
<xf:set var="$isActive" value="{{ is_toggle_set($forum.node_id, false, 'node-toggle') ? ' is-active' : '' }}"/>
<div class="block block--collapsible-child-nodes">
    <div class="block-container">
        <h3 class="block-minorHeader collapseTrigger collapseTrigger--block {$isActive} "
            data-target=".block--collapsible-child-nodes .block-body"
            data-xf-click="toggle"
            data-xf-init="toggle-storage-ex"
            data-storage-type="cookie"
            data-storage-container="node-toggle"
            data-storage-key="{$forum.node_id}"
            data-default-value="0"
            >{{ phrase('sub_forums') }}</h3>
<div class="block-body toggleTarget {$isActive}">
...
</div>

Télécharger V1.13.0 :

Version 1.13.1 :

- Add a work-around for horribly not recommended add-on updating process.
- Deleting an addon's files while the add-on is active will very likely break your site.

Télécharger V1.13.1 :

Version 1.14.0 - php compatibility update :

- Update bundled moment.js library
- php 8.2 compatibility update
- If using the Svg Template addon, update to SVG Template 2.4.5 or rendering SVGs to PNGs will stop working.

Télécharger V1.14.0 :

Version 1.15.0 - Minor feature update :
- Add controller plugin 'SV\StandardLib\ControllerPlugin\Delete' a plugin helper for implementing soft/hard/undeleting of content.

Télécharger V1.15.0 :

Version 1.15.2 :

- Fix join index hint support.
- Fix XF2.2.11 and before error: Undefined array key "indexHints".
- Fix XF2.212+ index hints not applying as expected in some cases.

Télécharger V1.15.2 :

Version 1.16.0 - Feature update :

- Add helper repository for manipulating permissions.
- Will be used by a number of upcoming updates for various add-ons.

Télécharger V1.16.0 :

Version 1.16.1 - Bugfix update :
- Fix caching global permissions was broken (Impacts Can Warn Staff & User Essentials, but depends heavily on content if this bug was triggered)

Télécharger V1.16.1 :

Version 1.17.0 - Feature update :

- Add "patch_route_build_callback" code event, used to manipulate the router state during construction.
- Add input filter option "empty-str-to-null". Example usage for developers :

PHP:

$foo = $this->filter('bar', '?uint,empty-str-to-null');

Télécharger V1.17.0 :

Version 1.18.0 - Feature update :

- Add support for addon.json 'require'/'require-soft' to support addon version strings instead of the addon version_id.
Uses version_compare under the hood after some very basic standardization.

php version strings support dotted versions, '1.2.3' and also each part may also support special character strings :

any string not found in this list < dev < alpha = a < beta = b < RC | Release Candidate = rc < # < patch level | pl = p.

Télécharger V1.18.0 :

Version 1.18.2 - Mini-feature & bugfix update :

Note; The 1.18.x branch will be the last branch to support XenForo 2.1.x

Deprecate getContentPermissions function, as the 2nd string argument was not actually used, with a replacement function getPerContentPermissions added.
Add \SV\StandardLib\Helper::isAddOnActive() helper function. Similar to \XF::isAddonActive(), except it understands version strings
Shim template funciton is_addon_active code to understand version strings

Télécharger V1.18.2 :

Version 1.18.3 - Bugfix update : Fix accidental hard XF2.2 requirement.

Télécharger V1.18.3 :

Version 1.18.4 - Bugfix update : Fix accidental hard XF2.2 requirement. Take #2

Télécharger V1.18.4 :

Version 1.19.0 - Feature update :

Only add phrase_dynamic template method in XF2.1
Add various strongly typed helpers to automatically type hint returns based on using ::class argument instead of magic strings.

PHP:

$obj = Helper::repository(\XF\Repository\User::class);

For static analysis and IDE, $obj will have the type \XF\Repository\User
While XF2.3 intends to implement this, adding this functionality to this add-on allows migrating before hand and simplifies migrating as the Helper bit just needs to be swapped with \XF
Add js/sv/lib/ajaxPagination.js

HTML:

<xf:js src="sv/vendor/domurl/url.js" addon="SV/StandardLib" min="1" />
<xf:js src="sv/lib/ajaxPagination.js" addon="SV/Threadmarks" min="1" />
...
<div class="block" data-xf-init="sv-ajax-pagination" data-content-wrapper=".block-body--wrapper">
    ...
    <div class="block-body--wrapper">
        ...
        <xf:pagenav ... />
        <xf:hiddenval name="final_url" value="{$finalUrl}" />
    </div>
</div>

<xf:pagenav> and <xf:hiddenval name="final_url" /> must be inside the div which is tagged with data-content-wrapper's css selector

Télécharger V1.19.0 :

Version V1.19.2 - Bugfix update :

Fix Who Replied pagination could get confused on the non-first page of a thread, similarly for ajax pagination code (used in Threadmarks v2.19.0+)
Fix ajax pagination could push changes to URL history when in an overlay

Télécharger V1.19.2 :

Version V1.19.3 - Bugfix update : Actually distribute minified ajaxPagination.js file

Télécharger V1.19.3 :

Version 1.19.4 : Fix Helper::createEntity() could cause "Call to undefined method ...\XF\Entity\...::where()" errors when verifying content is unique

Télécharger V1.19.4 :

Version 1.19.5 :

Fix Helper::find() and Helper::findCached() assumed entity ids are only ints (can be string/int/array)
Add Helper::instantiateEntity() type-safe wrapper

Télécharger V1.19.5 :

Version 1.20.0 :

Require php 7.2+
php 8.4+ compatibility fix
Improve custom AJAX pagination and AJAX pagination with filter bar javascript. Includes admincp option helper option rendering code
See Who Replied for an implementation of the feature allowing selectable pagination styles
Add Helper::Plugin for type-safe plugin creation

Version 1.20.1 :

Fix \SV\StandardLib\Helper::repo()->aliasClass() had a compatibility issue with XF2.2.13+ when the aliased class was the top-most class extension.

Télécharger V1.20.1 :

Version 1.21.1 - XenForo 2.3 support :

XF2.3 support
- Various .js files should work with XF2.1/XF2.2/XF2.3
Fix hasDesiredAddOnVersion could error if the target addon was in a processing state
Fix Standard Lib: Log parse_less_func debug info option not working
Backport <xf:macro name="template::macro syntax to to XF2.1
Update parse_less_color to not return CSS variables where possible

Bundle choices.js as a near drop-in replacement for select2

Enrich a select box with choices.js.

HTML:

<xf:macro template="svStandardLib_macros" name="choices_setup" />
<xf:selectrow label="Select row example" name="select_row_example"
              multiple="multiple"
              data-xf-init="sv-choices"
              data-placeholder="{{ phrase('example')|for_attr }}"
              data-max-item-count="2">
    <xf:option value="1">Option 1</xf:option>
    <xf:option value="2" selected="true">Option 2</xf:option>
    <xf:option value="3">Option 3</xf:option>
</xf:selectrow>

The initial structure is pre-rendered to reduce/prevent page jank.
To opt-out add the skip-rendering="true" attribute to the <xf:select> or <xf:selectrow> element
This will be used by a number of my add-ons and other 3rd party addons.

Télécharger V1.21.1 :

Version 1.21.2 - Bugfix update :

Fix ajax pagination & ajax filtered pagination code did not dynamically loading css/js
Update choices.js
- Various performance fixes when used with large number of options (ie hundreds of prefixes when using Multi-Prefix)
- Fix filtering/search could return unstable search results
- Fix possible empty aria-label generation on remove item button
- Fix enter could cause accidental form submit instead of open/closing the choices list in all cases

Télécharger V1.21.2 :

Version 1.21.3 - Maintenance update :

Fix bad reference to useNativeTimeInputs in README.md
Update choices.js (v11.0.0-rc7)
- Smaller bundle size
- Improve aria attribute handling (aka accessability)
- Many bugfixes around keyboard handling & displaying notices

Télécharger V1.21.3 :

Version 1.21.5 - Maintenance update :
- Update choices.js (v11.0.0-rc8)

Maintenance of choices.js is now done by Xon
When filtering/searching, show all search result hits instead of just the top 4.
Support all text/number configuration options as data-* attributes

Version 1.21.6 - Bugfix update : Fix "Class XFES\Listener not found" from some of my add-on installers.

Télécharger V1.21.6 :

Version 1.21.7 - Maintenance update :
- Update choices.js integration

Cleanup font-size handling (on average slightly larger, but works on more styles)
Convert CSS (generated from SCSS) into LESS
Fix adding classes to choices.js via data-class-* attributes did not work as expected
Fix a number of performance issues with very large number of options (ie hundreds to thousands), not fully resolved but better.

Télécharger V1.21.7 :

Version 1.21.9 - Bugfix update :

Update choices.js
- Adjust font-size css to be more inline with standard XF
- Fix select did not reset correct after a form submit.
  - Noticeable with Threadmarks Pro add-on on replying to a thread
- Fix "no choices to choose from"/"no results found" notice did not reliably trigger
- Fix options loader would unexpectedly clear options. This impacts the move thread function.
Update count down timer to only show seconds in the last 2 minutes by default, this avoid excessive page-reflows
- Noticeable with notice time replacables add-on

Télécharger V1.21.9 :

Version 1.21.10 - Bugfix update :
Update choices.js to v11.0.3

Fix accessibility around tab/shift//esc key handling
Fix "No choices to choose from" was displayed when it shouldn't be
Fix max item notice handling would stop displaying when it shouldn't
Fix HTML comments could be displayed as part of a item's text label when they shouldn't be.

Télécharger V1.21.10 :

Version 1.21.11 - Bugfix update :

- Fix XF2.3.5 compatibility
- Actually update choices.js to v11.0.3

Télécharger V1.21.11 :

Version 1.21.12 - Bugfix update :
- Fix javascript paginated filtering for XF2.3 support
- Used in (paid) Threadmarks Pro add-on and (free) Who Replied add-on

Version 1.21.13 - Bugfix update :
- Fix javascript paginated filtering for XF2.2 support
- Used in (paid) Threadmarks Pro add-on

Télécharger V1.21.13 :

Version 1.21.14 - Bugfix update :
- Update to choices.js v11.0.4

Fix selected option being escaped twice (Affects MultiPrefix editing a thread prefix)
Fix reaching maximum item limit notice is not cleared after removing selections
Fix
tab=> direction keys handling
Fix performance regression when loading options after choices.js object creation (Affects MultiPrefix loading per-forum prefixes)

Télécharger V1.21.14 :

Version 1.21.15 - Bugfix update :

Update to choices.js v11.0.6
- Fix regression where clicking the item would close & then re-open the dropdown instead of expected behavior
- Fix regression in setChoices API call (interaction with selected items, does not affect bundled select.js library)

Télécharger V1.21.15 :

Version 1.22.2 - Feature update :

Workaround unexpected behavior in \XF::options() and strongly typed property hints (generated by XF CLI command xf-dev:generate-options-stub) which may cause bugs in some add-ons
Update choices.js v11.1.0
- Remove role="textbox" from search input, per a11y practices
- Add choices.search-kmp.js build, more advanced than a simple prefix match but less complex than using FUSE for search
- Support <option label="..." /> HTML (not generated by XF natively)

Télécharger V1.22.2 :

Version 1.22.3 - Bugfix update : Fix single-select mode could incorrectly have multiple items selected when pre-rendering choices.js widget.

Télécharger V1.22.3 :

Version 1.22.4 - Maintenance update :
- Improve compatibility when using EarlyJoinFinderTrait and SqlJoinTrait together
- Avoid possible expensive table expression queries being computed multiple times

Télécharger V1.22.4 :

Version 1.22.5 - Maintenance & Bugfix update :

Partial workaround for buggy XF2.3 behavior around repository uniqueness. Does not affect call sites to \XF::repository, only Helper::repository
Fix incorrectly using SqlJoinTrait would swallow the actual error
Improve detection of excluding non-required joins when using EarlyJoinFinderTrait. This affects Multi Prefix is optimizing for matching on a single prefix, and also Extended Ignore
Remove usage of assert() for XF Cloud compatibility

Télécharger V1.22.5 :

Version 1.22.6 - Bugfix update :
- When using "AJAX pagination with filter bar" (js/sv/lib/xf/filter.js), fix invalid javascript error message when filtering by a value without pagination wrapper

Noticeable on the "logo selection" page of the Selectable logo (paid) add-on

Télécharger V1.22.6 :

laurent68 · 16 Aout 2020

Ajout de la version 1.1.1

laurent68 · 29 Septembre 2020

Ajout de la version 1.1.2

PowderPuff · 4 Octobre 2020

Thanks!

laurent68 · 22 Octobre 2020

Ajout de la version 1.2.1

Brad · 22 Octobre 2020

Merci pour la mise à jour qui doit être sans conséquence .

laurent68 · 2 Novembre 2020

Ajout de la version 1.3.1

lagrace · 2 Novembre 2020

merci pour cet addon

Brad · 2 Novembre 2020

Merci Laurent pour cette "'maj" aussi rapide !

Rammstein · 3 Novembre 2020

beaucoup d'addons a mettre a jour

laurent68 · 9 Novembre 2020

Ajout de la version 1.4.0

laurent68 · 12 Novembre 2020

Ajout de la version 1.4.1

rubicon · 28 Novembre 2020

Merci

laurent68 · 3 Decembre 2020

Ajout de la version 1.5.0

laurent68 · 11 Decembre 2020

Ajout de la version 1.5.1

laurent68 · 30 Decembre 2020

Ajout de la version 1.5.2

laurent68 · 4 Janvier 2021

Ajout de la version 1.5.3

laurent68 · 28 Janvier 2021

Ajout de la version 1.5.4

laurent68 · 15 Février 2021

Ajout de la version 1.6.0

Kaareth · 1 Mai 2021

Merci pour ce partage

XF 2.1 / 2.2 / 2.3 Standard Library by Xon 1.22.6

Add-on xenforo 2

Styles xenforo 2

Templates xenforo 2

Section Premium

XF 2.1 / 2.2 / 2.3 Standard Library by Xon 1.22.6

À propos de nous

Statistiques en ligne

Partager cette page

	XF 2.2 / 2.3 [XenGenTr] Core Library 1.1.0 blidi4ever 1 Aout 2025 Add-Ons
	XF 2.2 / 2.3 [MMO] Core Library 2.2.7 blidi4ever 1 Aout 2025 Add-Ons
	XF 2.1 / 2.2 / 2.3 [TC] Component Library 1.1.1 alesasss 6 Mars 2025 Add-Ons

XF 2.1 / 2.2 / 2.3 Standard Library by Xon 1.22.6

Add-on xenforo 2

Styles xenforo 2

Templates xenforo 2

Section Premium

XF 2.1 / 2.2 / 2.3 Standard Library by Xon 1.22.6

À propos de nous

Statistiques en ligne

Partager cette page

Restez connecté