Notes on sorting: Lexicographic vs Natural

database/migrations/2026_08_05_000000_add_sorting_description.php

@@ -0,0 +1,34 @@
+<?php
+
+/**
+ * SPDX-License-Identifier: MIT
+ * Copyright (c) 2017-2018 Tobias Reich
+ * Copyright (c) 2018-2026 LycheeOrg.
+ */
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class() extends Migration {
+	public const CAT = 'Theme Colors';
+
+	/**
+	 * Run the migrations.
+	 *
+	 *  @codeCoverageIgnore Tested but before CI run...
+	 */
+	final public function up(): void
+	{
+		DB::table('config_categories')->where('cat', 'Gallery')->update(['description' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>']);
+	}
+
+	/**
+	 * Reverse the migrations.
+	 *
+	 * @codeCoverageIgnore Tested but after CI run...
+	 */
+	final public function down(): void
+	{
+		DB::table('config_categories')->where('cat', 'Gallery')->update(['description' => '']);
+	}
+};

lang/ar/all_settings.php

@@ -836,7 +836,7 @@
     'category_description' => [
         'config' => '',
         'lychee SE' => 'افتح كامل إمكانيات Lychee مع <a href="https://lycheeorg.dev/get-supporter-edition/" class="text-primary-500 font-bold underline">النسخة الداعمة (Supporter Edition)</a>. احصل على ميزات حصرية وادعم تطوير Lychee. قم برعاية LycheeOrg على GitHub واحصل على مفتاح الترخيص الخاص بك <a href="https://github.com/sponsors/LycheeOrg" class="text-primary-500 font-bold underline">من هنا</a>.',
-        'Gallery' => '',
+        'Gallery' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>',
         'Mod Welcome' => 'تُفعّل هذه الوحدة صفحة هبوط. فبدلاً من الوصول مباشرة إلى عرض المعرض، تضيف هذه الصفحة لمسة من الفخامة إلى مدخل الموقع. أدخل رابط الصورة المراد عرضها وحدد العنوان.',
         'Footer' => '',
         'Smart Albums' => '',

lang/bg/all_settings.php

@@ -832,7 +832,7 @@
     'category_description' => [
         'config' => '',
         'lychee SE' => 'Отключете пълните възможности на Lychee със <a href="https://lycheeorg.dev/get-supporter-edition/" class="text-primary-500 font-bold underline">Supporter Edition</a>. Вземете ексклузивни функции и подкрепете разработката на Lychee. Станете спонсор на LycheeOrg в GitHub и вземете вашия лицензионен ключ <a href="https://github.com/sponsors/LycheeOrg" class="text-primary-500 font-bold underline">тук</a>.',
-        'Gallery' => '',
+        'Gallery' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>',
         'Mod Welcome' => 'Този модул активира начална страница. Вместо да попадате директно в изгледа на галерията, той добавя малко тържественост при влизането в уебсайта. Предоставете URL адреса на изображението, което да се показва, и задайте заглавие.',
         'Footer' => '',
         'Smart Albums' => '',

lang/cz/all_settings.php

@@ -836,7 +836,7 @@
     'category_description' => [
         'config' => '',
         'lychee SE' => 'Unlock the full capabilities of Lychee with the <a href="https://lycheeorg.dev/get-supporter-edition/" class="text-primary-500 font-bold underline">Supporter Edition</a>. Get exclusive features and support the development of Lychee. Sponsor LycheeOrg on GitHub and get your License key <a href="https://github.com/sponsors/LycheeOrg" class="text-primary-500 font-bold underline">here</a>.',
-        'Gallery' => '',
+        'Gallery' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>',
         'Mod Welcome' => 'This module enables a landing page. Instead of arriving directly to the gallery view, it adds a bit of grandiose to the website entrance. Provide the url of the picture to be displayed and set the title.',
         'Footer' => '',
         'Smart Albums' => '',

lang/de/all_settings.php

@@ -832,7 +832,7 @@
     'category_description' => [
         'config' => '',
         'lychee SE' => 'Schalten Sie den vollen Funktionsumfang von Lychee mit der <a href="https://lycheeorg.dev/get-supporter-edition/" class="text-primary-500 font-bold underline">Supporter Edition</a> frei. Erhalten Sie exklusive Funktionen und unterstützen Sie die Weiterentwicklung von Lychee. Werden Sie Sponsor von LycheeOrg auf GitHub und erhalten Sie Ihren Lizenzschlüssel <a href="https://github.com/sponsors/LycheeOrg" class="text-primary-500 font-bold underline">hier</a>.',
-        'Gallery' => '',
+        'Gallery' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>',
         'Mod Welcome' => 'Dieses Modul aktiviert eine Landingpage. Statt direkt in der Galerieansicht zu landen, verleiht sie dem Eingang Ihrer Website etwas mehr Glanz. Geben Sie die URL des anzuzeigenden Bildes an und legen Sie den Titel fest.',
         'Footer' => '',
         'Smart Albums' => '',

lang/el/all_settings.php

@@ -836,7 +836,7 @@
     'category_description' => [
         'config' => '',
         'lychee SE' => 'Unlock the full capabilities of Lychee with the <a href="https://lycheeorg.dev/get-supporter-edition/" class="text-primary-500 font-bold underline">Supporter Edition</a>. Get exclusive features and support the development of Lychee. Sponsor LycheeOrg on GitHub and get your License key <a href="https://github.com/sponsors/LycheeOrg" class="text-primary-500 font-bold underline">here</a>.',
-        'Gallery' => '',
+        'Gallery' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>',
         'Mod Welcome' => 'This module enables a landing page. Instead of arriving directly to the gallery view, it adds a bit of grandiose to the website entrance. Provide the url of the picture to be displayed and set the title.',
         'Footer' => '',
         'Smart Albums' => '',

lang/en/all_settings.php

@@ -836,7 +836,7 @@
     'category_description' => [
         'config' => '',
         'lychee SE' => 'Unlock the full capabilities of Lychee with the <a href="https://lycheeorg.dev/get-supporter-edition/" class="text-primary-500 font-bold underline">Supporter Edition</a>. Get exclusive features and support the development of Lychee. Sponsor LycheeOrg on GitHub and get your License key <a href="https://github.com/sponsors/LycheeOrg" class="text-primary-500 font-bold underline">here</a>.',
-        'Gallery' => '',
+        'Gallery' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>',
         'Mod Welcome' => 'This module enables a landing page. Instead of arriving directly to the gallery view, it adds a bit of grandiose to the website entrance. Provide the url of the picture to be displayed and set the title.',
         'Footer' => '',
         'Smart Albums' => '',

lang/es/all_settings.php

@@ -832,7 +832,7 @@
     'category_description' => [
         'config' => '',
         'lychee SE' => 'Aprovecha todas las funciones de Lychee con la <a href="https://lycheeorg.dev/get-supporter-edition/" class="text-primary-500 font-bold underline">Edición para patrocinadores</a>. Disfruta de funciones exclusivas y apoya el desarrollo de Lychee. Patrocina a LycheeOrg en GitHub y consigue tu clave de licencia <a href="https://github.com/sponsors/LycheeOrg" class="text-primary-500 font-bold underline">aquí</a>.',
-        'Gallery' => '',
+        'Gallery' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>',
         'Mod Welcome' => 'Este módulo permite crear una página de bienvenida. En lugar de acceder directamente a la vista de la galería, aporta un toque de solemnidad a la entrada del sitio web. Introduce la URL de la imagen que se va a mostrar y configura el título.',
         'Footer' => '',
         'Smart Albums' => '',

lang/fa/all_settings.php

@@ -836,7 +836,7 @@
     'category_description' => [
         'config' => '',
         'lychee SE' => 'با <a href="https://lycheeorg.dev/get-supporter-edition/" class="text-primary-500 font-bold underline">نسخه Supporter Edition</a> قابلیت‌های کامل Lychee را باز کنید. ویژگی‌های اختصاصی دریافت کنید و از توسعه Lychee حمایت کنید. از LycheeOrg در گیت‌هاب حمایت مالی کنید و کلید مجوز خود را <a href="https://github.com/sponsors/LycheeOrg" class="text-primary-500 font-bold underline">اینجا</a> دریافت کنید.',
-        'Gallery' => '',
+        'Gallery' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>',
         'Mod Welcome' => 'این ماژول یک صفحه فرود را فعال می‌کند. به‌جای ورود مستقیم به نمای گالری، کمی شکوه به ورودی وب‌سایت می‌افزاید. نشانی تصویری که باید نمایش داده شود را وارد کرده و عنوان را تنظیم کنید.',
         'Footer' => '',
         'Smart Albums' => '',

lang/fr/all_settings.php

@@ -832,7 +832,7 @@
     'category_description' => [
         'config' => '',
         'lychee SE' => 'Débloquez toutes les capacités de Lychee grâce à l’<a href="https://lycheeorg.dev/get-supporter-edition/" class="text-primary-500 font-bold underline">édition Supporter</a>. Bénéficiez de fonctionnalités exclusives et soutenez le développement de Lychee. Parrainez LycheeOrg sur GitHub et obtenez votre clé de licence <a href="https://github.com/sponsors/LycheeOrg" class="text-primary-500 font-bold underline">ici</a>.',
-        'Gallery' => '',
+        'Gallery' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>',
         'Mod Welcome' => 'Ce module active une page d\'accueil. Au lieu d\'accéder directement à la galerie, il ajoute une touche de grandeur à l\'entrée du site web. Indiquez l\'URL de l\'image à afficher et définissez le titre.',
         'Footer' => '',
         'Smart Albums' => '',

lang/hu/all_settings.php

@@ -836,7 +836,7 @@
     'category_description' => [
         'config' => '',
         'lychee SE' => 'Unlock the full capabilities of Lychee with the <a href="https://lycheeorg.dev/get-supporter-edition/" class="text-primary-500 font-bold underline">Supporter Edition</a>. Get exclusive features and support the development of Lychee. Sponsor LycheeOrg on GitHub and get your License key <a href="https://github.com/sponsors/LycheeOrg" class="text-primary-500 font-bold underline">here</a>.',
-        'Gallery' => '',
+        'Gallery' => '<span class="text-warning-600 font-bold uppercase">Important:</span> Natural sorting and lexicographical sorting can produce different results.<br><span class="text-muted-color text-muted">Natural: img_1, img_2, img_10.<br>Lexicographical: img_1, img_10, img_2.<br>Lexicographical sorting is performed directly in the database, while natural sorting is performed in PHP after the database query runs. As a result, when natural sorting is combined with pagination, results are fetched from the database in an arbitrary order before being sorted, which can lead to unexpected results when browsing through pages. We recommend using natural sorting for a small number of photos, and lexicographical sorting for a large number of photos. Alternatively, you can prefix your numbers with 0s (e.g. img_01, img_02, img_10) so that both sorting methods produce the same result.</span>',
         'Mod Welcome' => 'This module enables a landing page. Instead of arriving directly to the gallery view, it adds a bit of grandiose to the website entrance. Provide the url of the picture to be displayed and set the title.',
         'Footer' => '',
         'Smart Albums' => '',