🎯 Cel

Tworzenie wizualnego modułu kreatora przedmiotów dla systemu DLE 14.0, umożliwiającego zamianę dodatkowych pól (typu "jedna linia") na interfejs drag-n-drop z zapisem danych.
System musi być w pełni zintegrowany z panelu administracyjnego DLE i korzystać z szablonu dragitems.html jako wizualnego szablonu.

📁 Sekcja 1. Rozszerzenie typu pola dodatkowego "jedna linia"

W panelu administracyjnym DLE w sekcji edycji pól dodatkowych należy dodać nowy checkbox:

☑ Włącz kreator drag-n-drop przedmiotów

Ten checkbox jest dodawany tylko dla pól typu "jedna linia".

Po jego aktywacji:

• pole automatycznie zamienia się na interfejs drag-n-drop;

• po dezaktywacji wyświetla się zwykłe pole tekstowe;

• wartość checkboxa jest zapisywana w parametrze pola (np. editedxfield[28]).

Zachowanie musi być kompatybilne z systemem xfields:

• checkbox jest widoczny w formularzu edycji pola dodatkowego;

• jego wartość jest zapisywana i ładowana podczas edycji;

• w panelu administracyjnym, w formularzu dodawania/edycji newsu, na podstawie tego parametru włącza się interfejs drag-n-drop.

🪟 Sekcja 2. Okno modalne z przedmiotami (jedno źródło)

Tworzone jest jedno okno modalne, które:

• wyświetla dostępne przedmioty;

• działa ze wszystkimi polami, gdzie aktywowany jest drag-n-drop;

• jest otwierane i zamykane ręcznie przyciskiem;

• nie zamyka się automatycznie po wybraniu przedmiotów.

Źródło:

• Przedmioty są ładowane z kategorii DLE o ID = 11.

Każdy przedmiot musi mieć:

• pole itemimage (zdjęcie przedmiotu);

• pole rune-color (rodzaj obrażeń: red, orange, green, blue).

• Każdy przedmiot w modalu musi zawierać swoje ID.

• To ID będzie przekazywane do pola drag-n-drop podczas przeciągania.
  
  ❗ Każdy przedmiot w oknie modalnym musi zawierać swoje faktyczne ID (ID materiału), które będzie używane podczas przeciągania przedmiotu do strefy “drop”. Po upuszczeniu przedmiotu jego ID jest zapisywane jako ciąg wartości oddzielonych przecinkami — na przykład: 3,7,12,6,8. Te wartości stanowią końcową zawartość pola dodatkowego.

Filtrowanie:

• modal musi mieć filtry po kolorze (red, orange, green, blue);

• przycisk "Reset" pokazuje wszystkie przedmioty.

Wyjątki:

• w kodzie modułu można ustawić tablicę ID przedmiotów, które nie powinny się wyświetlać;
  przykład:

  php$excluded_items = [12, 57, 88];
  

📦 Sekcja 4. Technologia ładowania przedmiotów

Wszystkie przedmioty dla kreatora są przechowywane jako zwykłe news w kategorii DLE o ID = 11.

Podczas otwierania formularza dodawania lub edycji newsu:

JavaScript wysyła żądanie AJAX do specjalnego pliku PHP (np. load_items.php), który:

• ładuje wszystkie newsy z kategorii 11;

• czyta pola dodatkowe itemimage i rune-color;

• wyklucza podane ID (np. $excluded_items = [12, 45]);

• zwraca JSON lub HTML z listą przedmiotów.

Po otrzymaniu danych:

• moduł wyświetla przedmioty w modalce;

• pozwala na filtrowanie po kolorze;

• pozwala na przeciąganie do dowolnego aktywnego pola.

🔧 Sekcja 5. Zachowanie i logika pól drag-n-drop

Każde pole z włączonym drag-n-drop:

• wyświetla obszar, do którego można przeciągać przedmioty;

• wyświetla aktualnie wybrane przedmioty (ikony) w ustalonym porządku;

• pozwala na zmianę kolejności przez przeciąganie;

• pozwala na usunięcie przedmiotu (ikona z krzyżykiem);

• nie dopuszcza powtórnego dodania tego samego przedmiotu;

• zapisuje wybrane ID jako ciąg oddzielony przecinkami (np.: 3,7,12,6,8).

Pola muszą mieć unikalne ID i być powiązane z input name="xfield[nazwa]".

Powinna istnieć możliwość używania wielu takich pól na jednej stronie.

💾 Sekcja 6. Zachowanie przy zapisie i edycji

Podczas zapisywania newsu:

• wybrane przedmioty są zapisywane w ukrytym polu input;

• wartość ta jest przekazywana do DLE i zapisywana jako zwykła wartość pola dodatkowego.

Podczas ponownej edycji:

• moduł odczytuje ciąg ID (np.: "5,9,14");

• na podstawie tych ID odtwarzane są przedmioty w interfejsie w odpowiedniej kolejności;

• użytkownik widzi te same przedmioty, które zostały zapisane, i może je edytować.

Cała logika jest zachowana w ramach standardowego mechanizmu DLE xfields.

🎨 Sekcja 7. Projekt i realizacja

• Używać designu i stylów z szablonu dragitems.html

🎛️ Sekcja 8. Zachowanie drag-n-drop i modal

Przeciąganie:

• użytkownik może zmieniać kolejność przedmiotów;

• placeholder pokazuje miejsce wstawienia;

• brak ograniczeń na przemieszczanie, poza sprawdzaniem duplikatów.

Okno modalne:

• zawsze dostępne przy dodawaniu lub edycji newsu;

• nie zamyka się automatycznie po wybraniu;

• działa dla wszystkich stref drag-n-drop na stronie.

📑 Sekcja 9. Co dostarczyć:

Pełny działający moduł:

• łatka do xfields.php i wszystkich niezbędnych plików

• instrukcje instalacji.

Dokumentacja:

• dotycząca podłączenia modułu i konfiguracji.

Kompatybilność:

• Pełna kompatybilność z DLE 14.0 oraz

• modułem xField Tab — grupowanie pól dodatkowych w zakładki.