@ozguraltan/strapi-content-input 0.0.0-stage → 1.0.4
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.
- package/README.md +353 -2
- package/dist/admin/ContentInputField-CmfnTMVL.js +13891 -0
- package/dist/admin/ContentInputField-DWTaFM9i.mjs +13888 -0
- package/dist/admin/en-BRL85DLZ.js +7 -0
- package/dist/admin/en-ua8BQs0I.mjs +7 -0
- package/dist/admin/index-C7Z1NWlp.js +173 -0
- package/dist/admin/index-DhJXTZlO.mjs +172 -0
- package/dist/admin/index.js +5 -0
- package/dist/admin/index.mjs +5 -0
- package/dist/admin/src/components/ContentInputField.d.ts +23 -0
- package/dist/admin/src/components/editor/CIContextMenu.d.ts +2 -0
- package/dist/admin/src/components/editor/CanvasNodes.d.ts +20 -0
- package/dist/admin/src/components/editor/VECanvas.d.ts +2 -0
- package/dist/admin/src/components/editor/VEInsertPoint.d.ts +7 -0
- package/dist/admin/src/components/editor/VELeftPanel.d.ts +5 -0
- package/dist/admin/src/components/editor/VENodeToolbar.d.ts +13 -0
- package/dist/admin/src/components/editor/VEPreviewFrame.d.ts +7 -0
- package/dist/admin/src/components/editor/VETopBar.d.ts +5 -0
- package/dist/admin/src/components/editor/VisualEditorModal.d.ts +6 -0
- package/dist/admin/src/components/editor/inspector/VEInspector.d.ts +5 -0
- package/dist/admin/src/components/icons/MaterialIcon.d.ts +9 -0
- package/dist/admin/src/components/widgets/MenuWidgetEditor.d.ts +30 -0
- package/dist/admin/src/components/widgets/RichHtmlEditor.d.ts +8 -0
- package/dist/admin/src/components/widgets/StrapiMediaPicker.d.ts +9 -0
- package/dist/admin/src/components/widgets/TabAccordionEditor.d.ts +26 -0
- package/dist/admin/src/components/widgets/WidgetEditor.d.ts +10 -0
- package/dist/admin/src/components/widgets/WidgetPreview.d.ts +9 -0
- package/dist/admin/src/core/EditorContext.d.ts +134 -0
- package/dist/admin/src/core/canvasClasses.d.ts +9 -0
- package/dist/admin/src/core/clipboard.d.ts +9 -0
- package/dist/admin/src/core/devices.d.ts +16 -0
- package/dist/admin/src/core/history.d.ts +13 -0
- package/dist/admin/src/core/i18n.d.ts +2 -0
- package/dist/admin/src/core/presets.d.ts +23 -0
- package/dist/admin/src/core/sampleData.d.ts +2 -0
- package/dist/admin/src/core/treeOps.d.ts +10 -0
- package/dist/admin/src/core/types.d.ts +72 -0
- package/dist/admin/src/index.d.ts +14 -0
- package/dist/admin/src/pluginId.d.ts +1 -0
- package/dist/admin/src/styles/ciCanvasStyles.d.ts +2 -0
- package/dist/admin/tr-BmB19xV-.js +7 -0
- package/dist/admin/tr-Dg7KhusF.mjs +7 -0
- package/dist/server/index.js +702 -0
- package/dist/server/index.mjs +702 -0
- package/dist/server/src/bootstrap.d.ts +5 -0
- package/dist/server/src/config/index.d.ts +7 -0
- package/dist/server/src/content-types/ci-menu/schema.json.d.ts +46 -0
- package/dist/server/src/content-types/ci-template/schema.json.d.ts +42 -0
- package/dist/server/src/content-types/index.d.ts +88 -0
- package/dist/server/src/controllers/ci-menu.d.ts +12 -0
- package/dist/server/src/controllers/ci-template.d.ts +9 -0
- package/dist/server/src/controllers/index.d.ts +20 -0
- package/dist/server/src/destroy.d.ts +5 -0
- package/dist/server/src/index.d.ts +187 -0
- package/dist/server/src/register.d.ts +5 -0
- package/dist/server/src/routes/index.d.ts +14 -0
- package/dist/server/src/services/ci-menu.d.ts +36 -0
- package/dist/server/src/services/ci-template.d.ts +16 -0
- package/dist/server/src/services/index.d.ts +51 -0
- package/package.json +89 -4
package/README.md
CHANGED
|
@@ -1,3 +1,354 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @ozguraltan/strapi-plugin-content-input
|
|
2
2
|
|
|
3
|
-
|
|
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
|
+

|
|
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
|
+

|
|
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
|
+

|
|
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
|
+

|
|
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
|
+

|
|
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
|
+

|
|
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
|
+

|
|
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
|
+

|
|
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
|
+

|
|
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`)
|