@ozguraltan/strapi-content-input 0.0.0-stage → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/README.md +353 -2
  2. package/dist/admin/ContentInputField-BM2WS_KZ.js +18227 -0
  3. package/dist/admin/ContentInputField-D6rlm6Te.mjs +18224 -0
  4. package/dist/admin/en-D7v9nv9J.mjs +9 -0
  5. package/dist/admin/en-DF-a59T_.js +9 -0
  6. package/dist/admin/index-BA2XyNVO.mjs +172 -0
  7. package/dist/admin/index-IuCWhUHI.js +173 -0
  8. package/dist/admin/index.js +5 -0
  9. package/dist/admin/index.mjs +5 -0
  10. package/dist/admin/src/components/ContentInputField.d.ts +23 -0
  11. package/dist/admin/src/components/editor/CIContextMenu.d.ts +2 -0
  12. package/dist/admin/src/components/editor/CanvasNodes.d.ts +21 -0
  13. package/dist/admin/src/components/editor/VECanvas.d.ts +2 -0
  14. package/dist/admin/src/components/editor/VEInsertPoint.d.ts +7 -0
  15. package/dist/admin/src/components/editor/VELeftPanel.d.ts +5 -0
  16. package/dist/admin/src/components/editor/VENodeToolbar.d.ts +13 -0
  17. package/dist/admin/src/components/editor/VEPreviewFrame.d.ts +7 -0
  18. package/dist/admin/src/components/editor/VETopBar.d.ts +5 -0
  19. package/dist/admin/src/components/editor/VisualEditorModal.d.ts +6 -0
  20. package/dist/admin/src/components/editor/inspector/StyleControls.d.ts +49 -0
  21. package/dist/admin/src/components/editor/inspector/UnitInput.d.ts +18 -0
  22. package/dist/admin/src/components/editor/inspector/VEInspector.d.ts +5 -0
  23. package/dist/admin/src/components/icons/MaterialIcon.d.ts +9 -0
  24. package/dist/admin/src/components/widgets/MenuWidgetEditor.d.ts +30 -0
  25. package/dist/admin/src/components/widgets/RichHtmlEditor.d.ts +8 -0
  26. package/dist/admin/src/components/widgets/StrapiMediaPicker.d.ts +9 -0
  27. package/dist/admin/src/components/widgets/TabAccordionEditor.d.ts +26 -0
  28. package/dist/admin/src/components/widgets/WidgetEditor.d.ts +12 -0
  29. package/dist/admin/src/components/widgets/WidgetPreview.d.ts +9 -0
  30. package/dist/admin/src/core/EditorContext.d.ts +144 -0
  31. package/dist/admin/src/core/canvasClasses.d.ts +21 -0
  32. package/dist/admin/src/core/clipboard.d.ts +9 -0
  33. package/dist/admin/src/core/devices.d.ts +24 -0
  34. package/dist/admin/src/core/history.d.ts +13 -0
  35. package/dist/admin/src/core/i18n.d.ts +5 -0
  36. package/dist/admin/src/core/presets.d.ts +43 -0
  37. package/dist/admin/src/core/sampleData.d.ts +2 -0
  38. package/dist/admin/src/core/treeOps.d.ts +10 -0
  39. package/dist/admin/src/core/types.d.ts +79 -0
  40. package/dist/admin/src/index.d.ts +14 -0
  41. package/dist/admin/src/pluginId.d.ts +1 -0
  42. package/dist/admin/src/styles/ciCanvasStyles.d.ts +2 -0
  43. package/dist/admin/tr-ByHzf64V.mjs +9 -0
  44. package/dist/admin/tr-SNvSmKZQ.js +9 -0
  45. package/dist/server/index.js +702 -0
  46. package/dist/server/index.mjs +702 -0
  47. package/dist/server/src/bootstrap.d.ts +5 -0
  48. package/dist/server/src/config/index.d.ts +7 -0
  49. package/dist/server/src/content-types/ci-menu/schema.json.d.ts +46 -0
  50. package/dist/server/src/content-types/ci-template/schema.json.d.ts +42 -0
  51. package/dist/server/src/content-types/index.d.ts +88 -0
  52. package/dist/server/src/controllers/ci-menu.d.ts +12 -0
  53. package/dist/server/src/controllers/ci-template.d.ts +9 -0
  54. package/dist/server/src/controllers/index.d.ts +20 -0
  55. package/dist/server/src/destroy.d.ts +5 -0
  56. package/dist/server/src/index.d.ts +187 -0
  57. package/dist/server/src/register.d.ts +5 -0
  58. package/dist/server/src/routes/index.d.ts +14 -0
  59. package/dist/server/src/services/ci-menu.d.ts +36 -0
  60. package/dist/server/src/services/ci-template.d.ts +16 -0
  61. package/dist/server/src/services/index.d.ts +51 -0
  62. package/package.json +96 -4
package/README.md CHANGED
@@ -1,3 +1,354 @@
1
- # Temporary Holding Version
1
+ # @ozguraltan/strapi-plugin-content-input
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ **Strapi v5 için Görsel Sayfa ve İçerik Oluşturucu (Visual Page & Content Builder — JSONB Custom Field)**
4
+
5
+ `@ozguraltan/strapi-plugin-content-input`, Locomotive CMS (`cms-core`) bünyesindeki gelişmiş **ContentInput** görsel sayfa/içerik tasarım motorunu **Strapi v5** ekosistemine yerel bir `json` (`PostgreSQL JSONB`) özel alanı (**Custom Field**) olarak taşıyan bağımsız bir eklenti paketidir.
6
+
7
+ - **Paket Adı:** `@ozguraltan/strapi-plugin-content-input`
8
+ - **Custom Field UID:** `plugin::content-input.content-input`
9
+ - **Veritabanı Tipi:** `json` (PostgreSQL üzerinde `jsonb` olarak saklanır)
10
+ - **AI Agent Teknik Rehberi:** [AGENTS.md](./AGENTS.md)
11
+ - **PDF Sunum ve Kullanım Kılavuzu:** [docs/Strapi-Content-Input-Kullanim-Kilavuzu.pdf](./docs/Strapi-Content-Input-Kullanim-Kilavuzu.pdf)
12
+
13
+ ---
14
+
15
+ ## İçindekiler
16
+
17
+ 1. [Mevcut Bir Strapi v5 Projesine Kurulum ve Entegrasyon](#1-mevcut-bir-strapi-v5-projesine-kurulum-ve-entegrasyon)
18
+ 2. [Görsel Kılavuz ve Ekran Görüntüleri ile Davranış Analizi](#2-görsel-kılavuz-ve-ekran-görüntüleri-ile-davranış-analizi)
19
+ - [2.1 Yapı Görünümü (Structure View) ve Sürükle-Bırak](#21-yapı-görünümü-structure-view-ve-sürükle-bırak)
20
+ - [2.2 Tuval Görünümü (Inline Canvas Preview)](#22-tuval-görünümü-inline-canvas-preview)
21
+ - [2.3 Tam Ekran Görsel Editör (3 Panelli Stüdyo & Ölçekleme)](#23-tam-ekran-görsel-editör-3-panelli-stüdyo--ölçekleme)
22
+ - [2.4 Sekme (Tab) & Akordiyon İçinde HTML Editör + İç İçe ContentInput](#24-sekme-tab--akordiyon-içinde-html-editör--iç-içe-contentinput)
23
+ - [2.5 Sağ Tık Bağlam Menüsü (Context Menu) & Zengin HTML Editörü](#25-sağ-tık-bağlam-menüsü-context-menu--zengin-html-editörü)
24
+ - [2.6 Katmanlar (Layers) Ağacı ve 5 Kırılımlı Responsive Grid Ayarları](#26-katmanlar-layers-ağacı-ve-5-kırılımlı-responsive-grid-ayarları)
25
+ - [2.7 YouTube Video Editörü, Özel Kapak Görseli (Thumbnail) ve Pop-up Oynatıcı](#27-youtube-video-editörü-özel-kapak-görseli-thumbnail-ve-pop-up-oynatıcı)
26
+ - [2.8 Hiyerarşik (Nested) Menü Oluşturucu ve Strapi Entity/Ağaç Entegrasyonu](#28-hiyerarşik-nested-menü-oluşturucu-ve-strapi-entityağaç-entegrasyonu)
27
+ 3. [Desteklenen 13 Bileşen (Widget) Türü](#3-desteklenen-13-bileşen-widget-türü)
28
+ 4. [Üretilen JSONB Veri Mimarisi](#4-üretilen-jsonb-veri-mimarisi)
29
+ 5. [Lokal Geliştirme ve Playground Ortamı](#5-lokal-geliştirme-ve-playground-ortamı)
30
+
31
+ ---
32
+
33
+ ## 1. Mevcut Bir Strapi v5 Projesine Kurulum ve Entegrasyon
34
+
35
+ Bu eklentiyi halihazırda var olan herhangi bir **Strapi v5** projenize **3 farklı yöntemden** biriyle çekebilirsiniz. Derlenmiş `dist/` dosyaları Git deposuna dahil edildiği için doğrudan Git üzerinden kurulumda ekstra bir derleme adımına gerek kalmaz.
36
+
37
+ ### Adım 1: Paketi Strapi Projenize Çekin
38
+
39
+ Hedef Strapi v5 projenizin ana dizininde (`package.json` dosyasının bulunduğu klasörde) aşağıdaki yöntemlerden birini çalıştırın:
40
+
41
+ #### Yöntem A — GitLab Üzerinden Doğrudan Kurulum (Önerilen)
42
+ ```bash
43
+ npm install git+ssh://git@gitlab.com:ozguraltan/strapi-content-input.git
44
+ # veya yarn kullanıyorsanız:
45
+ yarn add git+ssh://git@gitlab.com:ozguraltan/strapi-content-input.git
46
+ ```
47
+ > **İpucu:** Eklentide yeni bir güncelleme yaptığınızda hedef Strapi projesinde `npm update @ozguraltan/strapi-plugin-content-input` veya aynı `npm install git+ssh://...` komutunu çalıştırmanız yeterlidir.
48
+
49
+ #### Yöntem B — Lokal Klasör Bağlantısı ile Kurulum (Aynı Bilgisayarda Geliştirme İçin)
50
+ ```bash
51
+ npm install file:../strapi-content-input
52
+ ```
53
+
54
+ #### Yöntem C — `.tgz` Paketi (`npm pack`) ile Kurulum
55
+ `strapi-content-input` dizininde `npm pack` çalıştırarak oluşan `ozguraltan-strapi-plugin-content-input-1.0.0.tgz` dosyasını hedef projede kurabilirsiniz:
56
+ ```bash
57
+ npm install /path/to/ozguraltan-strapi-plugin-content-input-1.0.0.tgz
58
+ ```
59
+
60
+ ---
61
+
62
+ ### Adım 2: `config/plugins.ts` (veya `config/plugins.js`) İçinde Eklentiyi Etkinleştirin
63
+
64
+ Hedef Strapi projenizin `config/plugins.ts` dosyasına `content-input` tanımını ekleyin:
65
+
66
+ ```ts
67
+ export default () => ({
68
+ 'content-input': {
69
+ enabled: true,
70
+ },
71
+ });
72
+ ```
73
+
74
+ ---
75
+
76
+ ### Adım 3: `config/middlewares.ts` İçinde Güvenlik Başlıklarını (CSP & Referrer-Policy) Yapılandırın
77
+
78
+ YouTube videolarının pop-up modal içinde sorunsuz oynatılabilmesi (`Error 153` almaması) ve harici görsellerin yüklenebilmesi için hedef projenizin `config/middlewares.ts` dosyasındaki `strapi::security` ayarını aşağıdaki gibi güncelleyin:
79
+
80
+ ```ts
81
+ export default [
82
+ 'strapi::logger',
83
+ 'strapi::errors',
84
+ {
85
+ name: 'strapi::security',
86
+ config: {
87
+ referrerPolicy: {
88
+ policy: 'strict-origin-when-cross-origin',
89
+ },
90
+ contentSecurityPolicy: {
91
+ useDefaults: true,
92
+ directives: {
93
+ 'connect-src': ["'self'", 'https:', 'http:'],
94
+ 'img-src': [
95
+ "'self'",
96
+ 'data:',
97
+ 'blob:',
98
+ 'https:',
99
+ 'http:',
100
+ 'https://images.unsplash.com',
101
+ 'https://img.youtube.com',
102
+ 'https://i.ytimg.com',
103
+ 'https://market-assets.strapi.io',
104
+ ],
105
+ 'media-src': ["'self'", 'data:', 'blob:', 'https:', 'http:'],
106
+ 'frame-src': [
107
+ "'self'",
108
+ 'https:',
109
+ 'http:',
110
+ 'https://www.youtube.com',
111
+ 'https://www.youtube-nocookie.com',
112
+ ],
113
+ 'child-src': [
114
+ "'self'",
115
+ 'https:',
116
+ 'http:',
117
+ 'https://www.youtube.com',
118
+ 'https://www.youtube-nocookie.com',
119
+ ],
120
+ upgradeInsecureRequests: null,
121
+ },
122
+ },
123
+ },
124
+ },
125
+ 'strapi::cors',
126
+ 'strapi::poweredBy',
127
+ 'strapi::query',
128
+ 'strapi::body',
129
+ 'strapi::session',
130
+ 'strapi::favicon',
131
+ 'strapi::public',
132
+ ];
133
+ ```
134
+
135
+ ---
136
+
137
+ ### Adım 4: İçerik Tipine (Content-Type) Alan Olarak Ekleyin
138
+
139
+ #### Seçenek 1 — Strapi Admin Arayüzünden (`Content-Type Builder`):
140
+ 1. Sol menüden **Content-Type Builder** ekranına gidin.
141
+ 2. Alan eklemek istediğiniz Collection Type veya Single Type'ı seçip **"+ Add another field"** butonuna tıklayın.
142
+ 3. **"Custom"** sekmesine geçin ve **"Content Input (Visual Builder)"** seçeneğini seçin.
143
+ 4. Alan adını (ör. `content` veya `body`) girip **Save** butonuna basın.
144
+
145
+ #### Seçenek 2 — `schema.json` Dosyasına Doğrudan Ekleyerek:
146
+ İlgili içerik tipinin `src/api/<icerik-tipi>/content-types/<icerik-tipi>/schema.json` dosyasına şu alanı ekleyin:
147
+
148
+ ```json
149
+ {
150
+ "attributes": {
151
+ "title": {
152
+ "type": "string",
153
+ "required": true
154
+ },
155
+ "content": {
156
+ "type": "customField",
157
+ "customField": "plugin::content-input.content-input"
158
+ }
159
+ }
160
+ }
161
+ ```
162
+
163
+ Ardından Strapi yönetim panelini derleyip başlatın:
164
+ ```bash
165
+ npm run build
166
+ npm run develop
167
+ ```
168
+
169
+ ---
170
+
171
+ ## 2. Görsel Kılavuz ve Ekran Görüntüleri ile Davranış Analizi
172
+
173
+ ### 2.1 Yapı Görünümü (Structure View) ve Sürükle-Bırak
174
+
175
+ Content Manager içinde kayıt düzenleme ekranı açıldığında varsayılan olarak **Yapı (Structure)** görünümü karşılar.
176
+ - **Hiyerarşik İskelet:** Sayfa yapısı `Satır (Row)` -> `12 Sütunlu Blok (Block)` -> `Bileşen (Widget)` hiyerarşisiyle gösterilir.
177
+ - **Sürükle-Bırak (Drag & Drop):** Satırların, blokların ve bileşenlerin solundaki `⋮⋮` tutamaçlarından sürükleyerek hem aynı blok/satır içinde sıralama değiştirebilir hem de bir bileşeni farklı bir bloğa veya satıra taşıyabilirsiniz.
178
+ - **Hızlı Şablon Ekleme:** Alt kısımdaki `+ Yeni Satır Ekle`, `+ 6 + 6`, `+ 4 + 4 + 4`, `+ 3 × 4`, `+ 8 + 4` butonlarıyla tek tıkla çok sütunlu satırlar oluşturabilirsiniz.
179
+
180
+ ![Yapı Görünümü (Structure View)](./docs/screenshots/01-structure-view.png)
181
+
182
+ ---
183
+
184
+ ### 2.2 Tuval Görünümü (Inline Canvas Preview)
185
+
186
+ Üst araç çubuğundaki **Tuval** sekmesine tıklandığında, tam ekran editöre geçmeden doğrudan Strapi formunun içinde sayfanın gerçek bileşen önizlemesi (galeri, metinler, sekmeler, videolar, menüler) canlı olarak görüntülenir.
187
+
188
+ ![Tuval Görünümü (Canvas View)](./docs/screenshots/02-canvas-view.png)
189
+
190
+ ---
191
+
192
+ ### 2.3 Tam Ekran Görsel Editör (3 Panelli Stüdyo & Ölçekleme)
193
+
194
+ **GÖRSEL EDİTÖRDE AÇ** butonuna tıklandığında 3 panelli tam ekran tasarım stüdyosu açılır:
195
+ - **Üst Araç Çubuğu:**
196
+ - **Sol / Sağ Menü Aç-Kapa (`Sol Menü` / `Sağ Menü`):** Sabit yan panelleri tek tıkla gizleyip açabilir veya kenar çizgilerinden **sürükleyerek genişliklerini (resizable) değiştirebilirsiniz**.
197
+ - **Kırılım Noktaları (`SM`, `MD`, `LG`, `XL`, `2XL`):** Farklı ekran boyutları arasında anında geçiş yapar.
198
+ - **Özel Piksel Genişlik ve Ölçekleme (`1024px`, `Sığdır`, `%50`–`%125`):** `cms-core`'daki gibi tuvali istediğiniz piksel genişliğine ayarlayabilir veya ekrana otomatik sığdırabilirsiniz (`Sığdır`).
199
+ - **Önizleme Modu (`Önizleme`):** Tüm kenarlık ve seçim çerçevelerini gizleyerek saf son kullanıcı görünümünü sunar.
200
+ - **Sol Panel:** Bileşen kütüphanesi (`Bileşenler`), sayfa ağacı (`Katmanlar`) ve hazır satır düzenleri (`Şablonlar`).
201
+ - **Sağ Panel (Özellik Denetçisi):** Seçili satır, blok veya bileşenin içerik, stil ve responsive ızgara ayarlarını gerçek zamanlı düzenler.
202
+
203
+ ![Tam Ekran Görsel Editör](./docs/screenshots/03-visual-editor-tab-html.png)
204
+
205
+ ---
206
+
207
+ ### 2.4 Sekme (Tab) & Akordiyon İçinde HTML Editör + İç İçe ContentInput
208
+
209
+ Sekme (`tab`) ve Akordiyon (`accordion`) bileşenlerinin her bir öğesi **iki farklı içerik modunu** destekler:
210
+ 1. **HTML Editör (Varsayılan):** Sekme veya akordiyon paneli içine doğrudan zengin metin, liste, başlık ve bağlantı yazılabilir.
211
+ 2. **Görsel Bloklar (`ContentInput`):** Sekme veya akordiyon paneli içine **yeni bir `ContentInput` ızgarası (satırlar, sütunlar, galeriler, formlar, videolar)** gömülebilir. **"İçerik Tasarla (ContentInput)"** butonuna basıldığında o sekmenin iç ızgarası için iç içe Görsel Editör açılır.
212
+
213
+ ![Sekme ve Akordiyon İç İçe ContentInput Modu](./docs/screenshots/04-tab-nested-content-input.png)
214
+
215
+ ---
216
+
217
+ ### 2.5 Sağ Tık Bağlam Menüsü (Context Menu) & Zengin HTML Editörü
218
+
219
+ - **Sağ Tık Bağlam Menüsü (`CIContextMenu`):** Hem Yapı/Tuval görünümlerinde hem de Görsel Editör'de herhangi bir **Bileşen**, **Blok** veya **Satır** üzerine sağ tıklandığında hızlı işlem menüsü açılır:
220
+ - *Bileşeni Düzenle (Pencere)* / *Ayarlar (Sağ Denetçi)*
221
+ - *Üstüne / Altına Bileşen veya Satır Ekle*
222
+ - *Yukarı / Aşağı Taşı (`Alt+↑` / `Alt+↓`)*
223
+ - *Çoğalt (`Ctrl+D`)*, *Kopyala (`Ctrl+C`)*, *Yapıştır (`Ctrl+V`)*, *Sil (`Del`)*
224
+ - **Zengin HTML Editörü (`RichHtmlEditor`):**
225
+ - Varsayılan olarak **WYSIWYG Görsel Modda** çalışır; yalnızca **`<> Kaynak`** butonuna basıldığında ham HTML kodunu gösterir.
226
+ - Arka plan rengi özellikle belirtilmedikçe **transparan (`transparent`)** olarak render edilir.
227
+ - **`Link`** ve **`Dosya / Medya Linki`** butonlarıyla hem harici URL'lere bağlantı verebilir hem de **Strapi Medya Kütüphanesindeki yüklü dosyalar (PDF, görsel, doküman vb.) içinde gezerek indirme (`download`) bağlantısı** ekleyebilirsiniz.
228
+
229
+ ![Sağ Tık Bağlam Menüsü ve Zengin HTML Editörü](./docs/screenshots/05-context-menu-and-rich-html.png)
230
+
231
+ ---
232
+
233
+ ### 2.6 Katmanlar (Layers) Ağacı ve 5 Kırılımlı Responsive Grid Ayarları
234
+
235
+ - **Katmanlar Sekmesi:** Sol paneldeki **Katmanlar** sekmesi tüm sayfa ağacını (`Satır -> Blok -> Bileşen`) listeler; buradan sürükle-bırak ile sıralama değiştirebilir veya sağ tıklayarak bağlam menüsünü açabilirsiniz.
236
+ - **Duyarlı (Responsive) Sütun Yönetimi:** Bir bloğa tıklandığında sağ denetçide `SM`, `MD`, `LG`, `XL` ve `2XL` kırılımları için **Sütun Genişliği (`1/12` – `12/12`)**, **Sol Boşluk / Offset (`0/12` – `11/12`)** ve **Metin Hizalama** ayrı ayrı ayarlanabilir.
237
+
238
+ ![Katmanlar Ağacı ve Responsive Grid Ayarları](./docs/screenshots/06-layers-and-responsive-grid.png)
239
+
240
+ ---
241
+
242
+ ### 2.7 YouTube Video Editörü, Özel Kapak Görseli (Thumbnail) ve Pop-up Oynatıcı
243
+
244
+ YouTube bileşeni (`youtubeVideo`) kurumsal sitelerdeki modern video deneyimini eksiksiz karşılayacak şekilde tasarlanmıştır:
245
+ - **Pop-up'ta Göster (Varsayılan: Açık):** Tıklandığında videoyu sayfa düzenini bozmadan şık bir pop-up (lightbox modal) pencerede açar. İstenirse işaret kaldırılarak kartın kendi içinde (inline) oynatılması sağlanabilir.
246
+ - **Özel Kapak Görseli / Thumbnail (`StrapiMediaPicker`):** **"Medya Seç"** butonuna basıldığında Strapi Medya Kütüphanesindeki yüklü görseller listelenir (veya yeni görsel yüklenir). Özel bir görsel seçildiğinde standart YouTube kartı yerine bu görsel kapak olarak kullanılır ve **üzerine gelindiğinde (hover) ortada Play butonu** belirir.
247
+
248
+ ![YouTube Video Editörü ve Özel Kapak Görseli](./docs/screenshots/07-youtube-editor-custom-thumbnail.png)
249
+
250
+ Play butonuna veya kapak görseline tıklandığında açılan **YouTube Pop-up Modal** içinde video doğrudan oynatılır; bileşende birden fazla video varsa modal alt barından videolar arasında geçiş yapılabilir:
251
+
252
+ ![YouTube Pop-up Lightbox Oynatıcı Modal](./docs/screenshots/08-youtube-popup-modal-player.png)
253
+
254
+ ---
255
+
256
+ ### 2.8 Hiyerarşik (Nested) Menü Oluşturucu ve Strapi Entity/Ağaç Entegrasyonu
257
+
258
+ Menü bileşeni (`menu`), hem özel bağlantıları hem de Strapi içindeki tüm içerik tiplerini (Collection Types) destekleyen tam kapsamlı bir navigasyon yöneticisidir:
259
+ - **Yatay ve Düşey Görünüm:** Üst açılır menü (**Yatay / Dropdown**) veya yan açılır-kapanır ağaç menü (**Düşey / Sidebar Tree**) olarak kullanılabilir.
260
+ - **Sınırsız Alt Kırılım (Nested Tree):** Menü öğeleri `→` (Alt Kırılıma Kaydır), `←` (Üst Kırılıma Çıkar), `↑`, `↓` ve `+` (Alt Öğe Ekle) butonlarıyla sınırsız derinlikte ağaç yapısına dönüştürülebilir.
261
+ - **Veritabanında Kayıtlı Menüler (`plugin::content-input.ci-menu`):** Oluşturduğunuz bir menüyü **"Bu Menüyü Veritabanına Kaydet / Güncelle"** butonuyla PostgreSQL'e kaydedebilir ve diğer sayfalarda tek tıkla çağırabilirsiniz.
262
+ - **Strapi Entity Arama & Ağaç Görünümü:** `Sayfalar (api::page.page)` gibi herhangi bir Strapi modülünü seçip kayıtlar içinde arama yapabilir, **Ağaç** veya **Liste** görünümünden tekil ya da **"+ Altlarıyla Ekle"** butonuyla tüm alt sayfalarıyla birlikte hiyerarşik olarak menüye aktarabilirsiniz.
263
+
264
+ ![Hiyerarşik Menü Oluşturucu ve Strapi Entity Ağacı](./docs/screenshots/09-hierarchical-menu-builder.png)
265
+
266
+ ---
267
+
268
+ ## 3. Desteklenen 13 Bileşen (Widget) Türü
269
+
270
+ | Kategori | Bileşen ID | Etiket | Açıklama |
271
+ | :--- | :--- | :--- | :--- |
272
+ | **Temel İçerik** | `HtmlEditor` | Metin Editörü | WYSIWYG zengin metin, kaynak kodu, dosya indirme linki ve transparan arka plan |
273
+ | **Temel İçerik** | `heading` | Başlık | `H1`–`H6` seviye, hizalama ve renk seçenekli başlık |
274
+ | **Temel İçerik** | `button` | Buton | `primary`, `secondary`, `outline`, `ghost` varyantlı aksiyon butonu |
275
+ | **Temel İçerik** | `spacer` | Boşluk | Piksel yüksekliği ve isteğe bağlı ayırıcı çizgi (divider) |
276
+ | **Medya & Görsel** | `singleImage` | Tek Görsel | Strapi Medya Kütüphanesi entegrasyonlu, altyazılı ve linkli görsel |
277
+ | **Medya & Görsel** | `gallery` | Galeri | Çoklu görsel kaydırıcı (`carousel`) veya çok sütunlu ızgara (`grid`) |
278
+ | **Medya & Görsel** | `youtubeVideo` | YouTube Video | Pop-up modal oynatıcı (varsayılan açık), özel kapak görseli ve çoklu video |
279
+ | **Düzen & Etkileşim** | `tab` | Sekme (Tab) | Her sekmede HTML Editör (varsayılan) veya iç içe `ContentInput` ızgarası |
280
+ | **Düzen & Etkileşim** | `accordion` | Akordiyon | Her panelde HTML Editör (varsayılan) veya iç içe `ContentInput` ızgarası |
281
+ | **Dinamik & Modüller** | `menu` | Menü | Yatay/Düşey nested ağaç menü, DB şablon kaydı ve Strapi Entity arama/ağaç |
282
+ | **Dinamik & Modüller** | `contentForm` | Form | Dinamik form kimliği, aksiyon butonu ve yönlendirme adresi |
283
+ | **Dinamik & Modüller** | `iframe` | Iframe | Harita veya harici sayfa yerleştirme (özelleştirilebilir yükseklik) |
284
+ | **Dinamik & Modüller** | `banner` | Banner | Kampanya ve tanıtım alanı (`grid` / `carousel`) |
285
+
286
+ ---
287
+
288
+ ## 4. Üretilen JSONB Veri Mimarisi
289
+
290
+ Strapi REST veya GraphQL API üzerinden bir kaydı çektiğinizde `content` alanı doğrudan aşağıdaki JSON dizisini döndürür:
291
+
292
+ ```json
293
+ [
294
+ {
295
+ "_uId": "row_1",
296
+ "cols": [],
297
+ "offset": [0, 0, 0, 0, 0],
298
+ "layoutProps": {
299
+ "align": ["start", "start", "start", "start", "start"]
300
+ },
301
+ "styleOptions": {
302
+ "backgroundColor": "#f5f7fa",
303
+ "padding": "32px 24px",
304
+ "borderRadius": "8px"
305
+ },
306
+ "bgImage": null,
307
+ "bgOptions": {},
308
+ "parallax": false,
309
+ "blocks": [
310
+ {
311
+ "_uId": "block_1",
312
+ "cols": [12, 12, 6, 6, 6],
313
+ "offset": [0, 0, 0, 0, 0],
314
+ "layoutProps": {},
315
+ "styleOptions": { "padding": "16px" },
316
+ "widgets": [
317
+ {
318
+ "_uId": "widget_1",
319
+ "id": "HtmlEditor",
320
+ "options": {},
321
+ "data": "<h2>Kurumsal Çözümler</h2><p>Detaylı açıklama metni...</p>"
322
+ }
323
+ ]
324
+ }
325
+ ]
326
+ }
327
+ ]
328
+ ```
329
+
330
+ > Tüm bileşenlerin detaylı TypeScript arayüzleri ve alt veri şemaları için **[AGENTS.md](./AGENTS.md)** dosyasına başvurabilirsiniz.
331
+
332
+ ---
333
+
334
+ ## 5. Lokal Geliştirme ve Playground Ortamı
335
+
336
+ Bu repo içinde eklentiyi anında test edebileceğiniz hazır bir **Strapi v5 Playground** (`./playground`) ve **Docker PostgreSQL** kurulumu yer almaktadır:
337
+
338
+ ```bash
339
+ # 1. PostgreSQL ve Adminer konteynerlerini başlatın
340
+ npm run db:up
341
+
342
+ # 2. Eklentiyi derleyin ve doğrulayın
343
+ npm run build
344
+ npm run verify
345
+
346
+ # 3. Playground uygulamasını derleyip başlatın
347
+ cd playground
348
+ npm run build
349
+ npm run develop
350
+ ```
351
+
352
+ - **Strapi Admin Paneli:** `http://localhost:1337/admin`
353
+ - **Varsayılan Giriş Bilgileri:** `ozguraltan05@gmail.com` / `12345678`
354
+ - **Adminer (PostgreSQL Arayüzü):** `http://localhost:8082` (`strapi` / `strapi_password` / DB: `strapi_ci`)