@ozguraltan/strapi-content-input 1.0.12 → 1.0.21

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 (39) hide show
  1. package/README.md +156 -49
  2. package/dist/admin/{AnalyticsHubPage-DNREITPq.js → AnalyticsHubPage-0p0Mx4AU.js} +60 -9
  3. package/dist/admin/{AnalyticsHubPage-Dj4roAe0.mjs → AnalyticsHubPage-DsrcGI_Y.mjs} +60 -9
  4. package/dist/admin/{ContentInputField-2hk9xG8p.js → ContentInputField-7rWLSx_7.js} +11995 -1174
  5. package/dist/admin/{ContentInputField-Ko-r12jl.mjs → ContentInputField-CHXrzvE-.mjs} +11813 -1010
  6. package/dist/admin/{SurveyWidgetEditor-B1S83aBE.mjs → SurveyWidgetEditor-BVN6X_3G.mjs} +3944 -1089
  7. package/dist/admin/{SurveyWidgetEditor-B3F4DE5r.js → SurveyWidgetEditor-BmgYQaQS.js} +3924 -1068
  8. package/dist/admin/{en-bneQpRJa.js → en-BZg845za.js} +2 -2
  9. package/dist/admin/{en-DnLdDKyq.mjs → en-C9LN2PJY.mjs} +2 -2
  10. package/dist/admin/{index-B4FpXxnK.js → index-CZAwXCFH.js} +16 -6
  11. package/dist/admin/{index-gn-4eO6g.mjs → index-hFIuYqu5.mjs} +16 -6
  12. package/dist/admin/index.js +1 -1
  13. package/dist/admin/index.mjs +1 -1
  14. package/dist/admin/src/components/color-codes/ColorCodesManager.d.ts +10 -0
  15. package/dist/admin/src/components/common/CIAspectRatioField.d.ts +35 -0
  16. package/dist/admin/src/components/common/CIColorField.d.ts +13 -0
  17. package/dist/admin/src/components/widgets/CustomCardWidgetEditor.d.ts +83 -0
  18. package/dist/admin/src/components/widgets/DataTableWidgetEditor.d.ts +65 -0
  19. package/dist/admin/src/components/widgets/EntityCardWidgetEditor.d.ts +10 -0
  20. package/dist/admin/src/components/widgets/HeroSliderStage.d.ts +153 -0
  21. package/dist/admin/src/components/widgets/HeroSliderWidgetEditor.d.ts +21 -0
  22. package/dist/admin/src/components/widgets/StrapiMediaPicker.d.ts +2 -0
  23. package/dist/admin/src/components/widgets/SurveyWidgetEditor.d.ts +1 -1
  24. package/dist/admin/src/core/colorUtils.d.ts +30 -0
  25. package/dist/admin/src/core/sampleData.d.ts +2 -1
  26. package/dist/admin/src/core/useColorCodes.d.ts +43 -0
  27. package/dist/admin/{tr-00QqO0E7.mjs → tr-MtQFY92V.mjs} +2 -2
  28. package/dist/admin/{tr-O0nhB9er.js → tr-ZEmzAvKR.js} +2 -2
  29. package/dist/server/index.js +990 -106
  30. package/dist/server/index.mjs +990 -106
  31. package/dist/server/src/content-types/ci-color-palette/schema.json.d.ts +52 -0
  32. package/dist/server/src/content-types/index.d.ts +50 -0
  33. package/dist/server/src/controllers/ci-color.d.ts +14 -0
  34. package/dist/server/src/controllers/index.d.ts +12 -0
  35. package/dist/server/src/index.d.ts +119 -0
  36. package/dist/server/src/services/ci-color.d.ts +127 -0
  37. package/dist/server/src/services/index.d.ts +57 -0
  38. package/dist/server/src/utils/mailer.d.ts +1 -0
  39. package/package.json +3 -2
package/README.md CHANGED
@@ -1,19 +1,22 @@
1
1
  # @ozguraltan/strapi-content-input
2
2
 
3
- **Visual Page & Content Builder (`JSONB` Custom Field), Dynamic Form Studio, Enterprise Survey & Analytics Hub, and Entity Card Engine for Strapi v5**
3
+ **Visual Page & Content Builder (`JSONB` Custom Field), Hero Slider, Data Tables, Custom Card Studio, Color Codes Theme Engine, Dynamic Form Studio & Enterprise Survey Hub for Strapi v5**
4
4
 
5
- `@ozguraltan/strapi-content-input` brings an enterprise-grade visual page and layout builder to **Strapi v5** as a native `json` (`PostgreSQL JSONB`) Custom Field (`plugin::content-input.content-input`), paired with official Vue 3 / Nuxt 3/4 storefront renderers for **Vuetify (`v3.5+` & `v4.+`)** and **Element Plus (`>=2.7.0 <4.0.0`)**.
5
+ `@ozguraltan/strapi-content-input` brings an enterprise-grade visual page and layout builder (**18 built-in widgets**) to **Strapi v5** as a native `json` (`PostgreSQL JSONB`) Custom Field (`plugin::content-input.content-input`), paired with official Vue 3 / Nuxt 3/4 storefront renderers for **Vuetify (`v3.5+` & `v4.+`)** and **Element Plus (`>=2.7.0 <4.0.0`)**.
6
6
 
7
7
  - **Strapi Plugin Package:** `@ozguraltan/strapi-content-input`
8
8
  - **Custom Field UID:** `plugin::content-input.content-input`
9
9
  - **Plugin Content-Types:**
10
+ - `plugin::content-input.ci-color-palette` (`ci_color_palettes` — Semantic & custom brand **Color Codes** palettes with `HEX`, `RGB/RGBA` & `--ci-color-*` CSS variables)
11
+ - `plugin::content-input.ci-template` (`ci_templates` — Reusable Row, Block, Widget & **Custom Card Design** templates)
10
12
  - `plugin::content-input.ci-menu` (`ci_menus` — Reusable hierarchical menus)
11
13
  - `plugin::content-input.ci-form` (`ci_forms` — Dynamic `cms-core`-style forms, validation rules & mail configs)
12
14
  - `plugin::content-input.ci-form-submission` (`ci_form_submissions` — Recorded form submissions & delivery logs)
13
15
  - `plugin::content-input.ci-survey` (`ci_surveys` — Multi-step surveys, quick polls, conditional skip logic, lifecycle & anti-duplicate rules)
14
16
  - `plugin::content-input.ci-survey-response` (`ci_survey_responses` — Recorded survey votes, completion duration, locale & salted voter hash)
15
- - **Strapi Admin Left Sidebar Page:** `/admin/plugins/content-input` (**Surveys & Forms Analytics Hub**)
17
+ - **Strapi Admin Left Sidebar Page:** `/admin/plugins/content-input` (**Surveys, Forms & Color Codes Hub**)
16
18
  - **Database Column Type:** `json` (stored as `JSONB` in PostgreSQL)
19
+ - **CI/CD & Packaging:** `dist/` is intentionally untracked in Git (`.gitignore`); packages compile automatically in GitLab CI (`.gitlab-ci.yml`) and on `npm install` via `"prepare": "npm run build"`.
17
20
  - **Companion Storefront Renderers:**
18
21
  - **Vuetify (3.5+ / 4.+):** `@ozguraltan/strapi-content-input-nuxt-vuetify` (`npx strapi-content-input-vuetify eject`)
19
22
  - **Element Plus (2.7+ / 3.x):** `@ozguraltan/strapi-content-input-nuxt-element-plus` (`npx strapi-content-input-ep eject`)
@@ -34,8 +37,9 @@ npm install @ozguraltan/strapi-content-input
34
37
  npm install git+ssh://git@gitlab.com:ozguraltan/strapi-content-input.git
35
38
  ```
36
39
 
37
- ### Step 2: Enable in `config/plugins.ts`
40
+ ### Step 2: Enable in `config/plugins.ts` & `config/features.ts`
38
41
  ```ts
42
+ // config/plugins.ts
39
43
  export default () => ({
40
44
  'content-input': {
41
45
  enabled: true,
@@ -43,6 +47,14 @@ export default () => ({
43
47
  });
44
48
  ```
45
49
 
50
+ For **Strapi v5.61+**, enable `useLegacyMediaLibrary: true` in `config/features.ts` so Strapi's full-featured classic **Media Library Modal** (with thumbnails, pagination, folder management, upload, and built-in Cropper.js image cropping) opens across all ContentInput widgets and full-screen studios:
51
+ ```ts
52
+ // config/features.ts
53
+ export default () => ({
54
+ useLegacyMediaLibrary: true,
55
+ });
56
+ ```
57
+
46
58
  ### Step 3: Configure Content Security Policy in `config/middlewares.ts`
47
59
  To allow YouTube iframe embeds and external/CDN media previews inside the Strapi Admin panel:
48
60
  ```ts
@@ -107,13 +119,14 @@ export default [
107
119
  ![Canvas View](./docs/screenshots/02-canvas-view.png)
108
120
  ![Full-Screen Visual Editor](./docs/screenshots/03-visual-editor-tab-html.png)
109
121
 
110
- ### 2.2 Built-in Media Library Studio & `sharp` On-the-Fly + CDN Thumbnail Pipeline
111
- - **Full Media Library Studio (`StrapiMediaPicker`):** Folder navigation & folder creation, multi-file upload, multi-select with order badges (`✓ 1`, `✓ 2`), type filtering (`Images`, `Videos`, `Docs`), metadata editing (`name`, `alternativeText`, `caption`, `folder`), asset deletion, and an interactive **Crop & Rotate Studio** (`Free`, `1:1`, `16:9`, `4:3`, `3:2`, `4:5`, `-90°/+90°`, `Duplicate & Crop` or `Crop Original Asset`).
122
+ ### 2.2 Official Strapi Native Media Library Modal + `sharp` On-the-Fly + CDN Thumbnail Pipeline
123
+ - **Official Strapi Media Library Modal (`components['media-library']` in `StrapiMediaPicker`):** Every media field across all 18 widgets and full-screen studios (`heroSlider` background image/video & floating layer, `customCard` media & author avatar, `entityCard`, `survey` image choice, `gallery`, `singleImage`, `youtubeVideo`, `banner`, `button`, `StyleControls`, and `RichHtmlEditor`) opens Strapi's **official native Media Library Dialog** (`z-index: 310` cleanly above all `200–270` ContentInput studios) with full-color thumbnails, pagination, folder navigation/creation, drag-and-drop upload, asset metadata editing, and Strapi's built-in **Cropper.js** cropper — plus an optional 1-click inline `sharp` **Crop & Rotate Studio** (`Free`, `1:1`, `16:9`, `4:3`, `3:2`, `4:5`, `-90°/+90°`, `Duplicate & Crop` or `Crop Original Asset`).
112
124
  - **On-the-Fly `sharp` Endpoint (`/api/content-input/image`) & Automatic CDN Upload:**
113
125
  - When a `gallery` widget uses `imageSettings` (`process: 'fit'` for `cWidth × cHeight` crop, or `process: 'widen'` for `cWidth` scaling), `sharp` generates the exact thumbnail on the backend, uploads the generated variant to Strapi's active Upload Provider / CDN (`strapi.plugin('upload').service('provider').upload`), persists the CDN URL in `file.formats['ci_fit_WxH']`, and caches it with immutable HTTP headers.
114
126
  - Clicking any gallery image opens the **Popup Lightbox** with the **full-resolution uncropped original image**.
115
- - **Official Swiper.js Engine (`swiper/react` & `swiper/vue`):**
116
- - Supports touch/mouse drag-to-swipe (`grabCursor`), mousewheel scrolling (`mousewheel`), transition effects (`slide`, `fade`, `cube`, `coverflow`, `flip`), `slidesPerView`, `spaceBetween`, `loop`, `autoplay`, `navigation`, and `pagination`.
127
+ - **Official Swiper.js Engine + Native Framework Navigation Buttons (`CISwiperNavButtons`):**
128
+ - Supports touch/mouse drag-to-swipe (`grabCursor`), mousewheel scrolling (`mousewheel`), transition effects (`slide`, `fade`, `cube`, `coverflow`, `flip`), `slidesPerView`, `spaceBetween`, `loop`, `autoplay`, and `pagination`.
129
+ - Replaces Swiper's oversized raw `.swiper-button-prev`/`.swiper-button-next` chevrons across `heroSlider`, `gallery`, `entityCard`, and `customCard` with genuine Vuetify `<v-btn>` and Element Plus `<el-button>` components supporting selectable **`navButtonStyle`** (`'fab' | 'outlined' | 'tonal' | 'icon' | 'square'`), **`navButtonSize`** (`'sm' | 'md' | 'lg'`), and Color Codes / `#HEX` / `RGBA` **`navButtonColor`**.
117
130
 
118
131
  ---
119
132
 
@@ -192,24 +205,72 @@ MAIL_ENCRYPTION=tls
192
205
 
193
206
  ---
194
207
 
195
- ## 4. Linked Strapi `entityCard` Widget (Entity Inheritance + Overrides + Universal Card Props)
208
+ ## 4. Linked Strapi `entityCard` Widget (Single Card, Swiper.js Carousel & Grid + Collection Feed)
209
+
210
+ The **`entityCard`** widget links to Strapi Collection-Type entries (e.g. `api::page.page`, `api::article.article`, `api::product.product`) and renders single cards, multi-item **Swiper.js Carousels**, or responsive grids:
211
+ 1. **Three Display Modes (`options.displayMode`):**
212
+ - `'single'` (default, backward-compatible): Displays one linked Strapi entity card.
213
+ - `'swiper'`: Renders multiple cards inside official **Swiper.js** (`slidesPerView` responsive `[sm, md, lg, xl, 2xl]`, `spaceBetween`, `loop`, `autoplay`, `navigation`, `pagination`, `mousewheel`, `effect`: `slide` / `coverflow` / `cards`).
214
+ - `'grid'`: Renders multiple linked entity cards in a responsive multi-column CSS grid.
215
+ 2. **Two Data Modes (`data.sourceMode`):**
216
+ - **Hand-Picked Multi-Entity List (`items[]`):** Pick multiple Strapi records, drag/reorder them, and set optional per-card manual `overrides`.
217
+ - **Automatic Collection Feed (`collectionFeed`):** Automatically pulls the latest `limit` published records from any Strapi collection (`GET ${baseUrl}/api/content-input/entity-cards?uid=...&sort=publishedAt:desc&limit=8`).
218
+ 3. **Automatic Entity Fallback + Granular Overrides:** Any override (`image`, `title`, `subtitle`, `description`, `badgeText`, `buttonText`, `url`, `target`, `accentColor`) left blank automatically inherits from the linked Strapi record (including extracting summary text & media from `ContentInput` JSONB!). Each card item can also define its own per-card **`accentColor`** via `<CIColorField />` (Color Codes token, `#HEX`, or `RGBA`).
219
+ 4. **Card Carousel Height Equalization (`options.heightMode` & `options.cardHeight`):** Supports `'equal'` (default — stretches all cards in a Swiper row or CSS grid to match the tallest card while pinning CTA buttons flush at the bottom), `'fixed'` (explicit `cardHeight` in `px`, e.g. `420px`), and `'auto'` (natural content height).
220
+ 5. **Universal Card Props & Color Codes (`options.cardProps`):** `layout` (`vertical` | `horizontal` | `overlay`), `variant` (`elevated` | `outlined` | `flat` | `tonal`), `elevation`, `rounded`, `color`, `textColor`, `accentColor` (all backed by `<CIColorField />` + Color Codes tokens), `imageHeight`, `showBadge`, `showButton`, `buttonVariant`, `hoverEffect`.
221
+ 6. **External Override Support:** Override globally via `:components="{ entityCard: MyEntityCard }"` or inline via `<template #widget-entityCard="{ entityCardData }">`.
196
222
 
197
- The **`entityCard`** widget links to any Strapi Collection-Type entry (e.g. `api::page.page`, `api::article.article`, `api::product.product`) and renders a rich card:
198
- 1. **Automatic Entity Fallback:** When an editor selects a Strapi entry (`entityUid` + `documentId`), `entityCard` automatically inherits `title`, `subtitle`, `description` (even extracting clean text & cover media from `ContentInput` JSONB!), `image`, `badgeText`, and `url` from the linked entity (`GET ${baseUrl}/api/content-input/entity-card`).
199
- 2. **Granular Manual Overrides:** Editors can optionally override `overrides.image`, `overrides.title`, `overrides.subtitle`, `overrides.description`, `overrides.badgeText`, `overrides.buttonText`, `overrides.url`, and `overrides.target`. Any override left blank seamlessly falls back to the linked entity!
200
- 3. **Universal Vuetify / Element Plus Card Props (`options.cardProps`):**
201
- - `layout`: `'vertical'` | `'horizontal'` | `'overlay'`
202
- - `variant`: `'elevated'` | `'outlined'` | `'flat'` | `'tonal'`
203
- - `elevation`: `0`–`24`
204
- - `rounded`: `'0'` | `'sm'` | `'md'` | `'lg'` | `'xl'`
205
- - `color`, `textColor`, `accentColor`, `imageHeight`, `showBadge`, `showButton`, `buttonVariant`, `hoverEffect`
206
- 4. **External Override Support:** Override globally via `:components="{ entityCard: MyEntityCard }"` or inline via `<template #widget-entityCard="{ entityCardData }">`.
223
+ ---
224
+
225
+ ## 5. Color Codes Theme Engine, Hero Slider, Data Tables & Custom Card Designer
226
+
227
+ ### 5.1 Color Codes (`plugin::content-input.ci-color-palette` & `<CIColorField />`)
228
+ Manage site-wide semantic and custom brand color tokens from **two places** in Strapi Admin (`Left Sidebar -> Surveys, Forms & Colors -> Color Codes` tab, or the **🎨 Color Codes** button in the Visual Editor top bar):
229
+ - **13 Semantic Tokens + Unlimited Custom Tokens:** `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`, `surface`, `surfaceAlt`, `background`, `textPrimary`, `textSecondary`, `border` plus custom tokens (e.g. `brandGold`, `ctaCoral`).
230
+ - **Multi-Mode Color Input Everywhere (`Visual Spectrum + #HEX + RGB/RGBA`):**
231
+ - Interactive 2D Saturation/Brightness Spectrum + Hue & Alpha (`0%–100%`) sliders.
232
+ - Explicit **`#HEX`** input (`#RRGGBB` & 8-digit `#RRGGBBAA`) with 1-click copy.
233
+ - Explicit **`RGB / RGBA`** numeric spinboxes (`R: 0–255`, `G: 0–255`, `B: 0–255`, `A: 0–100%`) AND direct `rgb(...)` / `rgba(...)` CSS string input.
234
+ - **"+ Save This Color to Color Codes"**: Save any custom `#HEX` / `rgba(...)` color directly into the active Color Codes palette on the fly from any widget/row/block inspector!
235
+ - **Live `--ci-color-*` CSS Variable Binding:** Widgets bound to a token store `var(--ci-color-primary, #4f46e5)` (plus automatic `--ci-color-primary-rgb` and `-soft` alpha variants). `<ContentInputPreview>` in both Nuxt packages fetches `GET ${baseUrl}/api/content-input/color-codes` (or accepts `:theme-slug="'emerald-fintech'"` / `:color-variables="{ '--ci-color-primary': '#059669' }"`) so switching palettes updates the entire storefront instantly without editing pages!
236
+
237
+ ### 5.2 Hero Slider (`heroSlider` — Homepage Multi-Layer Banner Engine & Scaled Live Studio)
238
+ Powered by official **Swiper.js** (`EffectFade`, `EffectCreative`, `EffectCoverflow`, `EffectCube`, `EffectFlip`, `Parallax`, `Autoplay`, `Navigation`, `Pagination`, `Mousewheel`):
239
+ - **Scaled Virtual Viewport Studio (`1280px` / `768px` / `390px` Mobile Portrait) & Live FX Playback:** The full-screen **Hero Slider Live Studio** renders slides at exact target viewport widths (`1280px` Desktop, `768px` Tablet, `390px` Mobile Portrait bezel) scaled dynamically with `ResizeObserver` (`Fit`, `50%`, `75%`, `100%`, `⤢ Zen` mode, `# Grid` `12×12` guide) and live `swiper/react` transition playback (`◀ ▶`, `↻ Efektleri Oynat`, `▶ Auto`).
240
+ - **Freeform Layer Positioning (`X, Y, Width, Height, Z-Index`) + Responsive Overrides:** Each layer (`badge`, `heading`, `subtitle`, `buttons`, `floating_image`, `stats`) supports `positionMode: 'flow' | 'free'`. In `'free'` mode, drag layers directly on the scaled stage or resize with **8 handles** (`dx / effectiveScale` compensated + `50%` center snap guides), use the **9-point quick-align matrix**, and define per-device coordinate overrides (`box`, `boxTablet`, `boxMobile`), `tabletFontSize` / `mobileFontSize`, and `hiddenOn`.
241
+ - **19 Common Aspect Ratio Presets + Manual `W : H` / Pixel Ratio (`<CIAspectRatioField />`):** Choose from **19 categorized presets** (`4:1`, `3:1`, `32:9`, `2.40:1`, `21:9`, `2:1`, `16:9`, `16:10`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `5:7`, `2:3`, `9:16`, `9:19.5`, `9:21`) or enter any custom ratio / pixel pair (`1920:680`, `2.35:1`) globally and per slide across Desktop, Tablet, and Mobile Portrait (also supported in `gallery`).
242
+ - **Dedicated Mobile Portrait Slides & Media Overrides:** Set per-slide `deviceVisibility` (`'all' | 'desktop_tablet' | 'mobile_only' | 'desktop_only' | 'tablet_only'`), clone a desktop slide into a `4:5` vertical mobile slide in 1 click via **"📱 Mobil Portrait Kopyası Türet"**, or set a mobile-only background override (`mobileBgType`, `mobileBgImage`, `mobileBgGradient`, `mobileBgVideoUrl`).
243
+ - **7 Built-in Typographic Effects & Ken Burns:** `none`, `gradient_text`, `typewriter` (live typing/deleting cursor), `rotating_words`, `highlight_marker`, `outline_stroke`, and `glow` + **Ken Burns** motion (`zoom-in`, `zoom-out`, `pan-left`, `pan-right`).
244
+
245
+ ### 5.3 Interactive Data Table (`dataTable`)
246
+ Supports **Excel / CSV File Upload**, **Clipboard Paste**, and **Live Strapi Collection** data sources:
247
+ 1. **Excel (`.xlsx`, `.xls`) & CSV (`.csv`, `.tsv`) File Upload + Paste Importer (`sourceMode: 'manual'`):** Upload `.xlsx`, `.xls`, `.csv`, or `.tsv` files via drag-and-drop dropzone (powered by `xlsx` / SheetJS with multi-sheet workbook selector, replace vs append mode, and automatic column type inference), paste directly from Excel / Google Sheets, or edit typed cells inline.
248
+ 2. **Live Strapi Collection Source + Selectable Fields (`sourceMode: 'strapi_collection'`):** Connect to any allowed Strapi Collection-Type (`GET ${baseUrl}/api/content-input/data-table?uid=api::page.page`), interactively pick **which collection fields** to display via an `availableFields` checklist, reorder columns, customize column headers/formats, and preview live records (`private` / `password` fields and `admin::*` UIDs are strictly blocked on the server).
249
+ 3. **Fixed (Sticky) Header + Horizontal & Vertical Scroll:** Configure `stickyHeader` (pins `<thead>` at `top: 0` while scrolling), `verticalScroll` + `maxHeight` (e.g. `360px`–`480px`), `horizontalScroll` + `minTableWidth` (e.g. `960px`–`1040px`), `stickyFirstColumn` (pins the first column at `left: 0` during horizontal scroll), and Color Codes `headerBgColor` / `headerTextColor`.
250
+ 4. **9 Rich Column Formats & Interactive Visitor Toolbar:** `text`, `number`, `currency`, `progress` (visual progress bar), `badge` (mapped to Color Codes semantic colors), `boolean`, `image` (with click-to-zoom lightbox), `date`, `link` — plus live search, column sorting, quick filter chips, pagination, summary footer (`SUM` / `AVG` / `COUNT`), zebra striping, and 1-click visitor **CSV Export**.
251
+
252
+ ### 5.4 Custom Card Designer (`customCard`)
253
+ Design bespoke cards visually without writing Vue/CSS code, and display them as a **Swiper.js Carousel**, **Responsive Grid**, or **Single Card**:
254
+ - **6 Built-in Card Archetypes:**
255
+ 1. `feature` — Icon / Media + Eyebrow + Title + Description + CTA
256
+ 2. `pricing` — Plan Name + Price (`₺` / `$` / `/mo`) + Highlighted **"MOST POPULAR"** Ribbon + `✓` Checklist + Full-Width CTA
257
+ 3. `testimonial` — Quote + 5-Star Rating + Author Avatar, Name & Role
258
+ 4. `profile` — Team Member Photo + Name, Title, Bio & Action Links
259
+ 5. `stat` — Big KPI Metric + Trend Badge (`+24.8% ↑`) + Context Label
260
+ 6. `overlay_story` — Full-bleed background image with gradient scrim & glassmorphism badge
261
+ - **Vertical Height Equalization, Scaled Live Carousel Stage & Per-Card Accent Color:** Toggle between **`🎯 Single Card`** and **`🎬 Scaled Live Stage` (`1280px` / `768px` / `390px`)** inside the Custom Card Designer Studio to preview multi-card Swiper carousels & grids live; set `heightMode: 'equal' | 'fixed' | 'auto'` (`cardHeight` in `px`) and override **`accentOverride`** per individual card item via `<CIColorField />`.
262
+ - **Visual Style Studio + Reusable Design Presets:** Customize border radius (`0–32px`), border, shadow/glassmorphism, hover animations (`lift`, `glow`, `scale`, `border-accent`), Color Codes bindings, and save/load card styles via **Saved Card Design Templates** (`plugin::content-input.ci-template`, `category: 'card_design'`).
263
+
264
+ ### 5.5 Tabs & Accordions Color Codes + Active Bottom Line Styling (`tab` & `accordion`)
265
+ Both `tab` and `accordion` widgets support full theme token (`var(--ci-color-*)`) and custom `<CIColorField />` (`#HEX` + `RGB/RGBA`) styling:
266
+ - **Header & Content Colors:** `headerBgColor`, `headerTextColor` (`fontColor`), `activeBgColor`, `activeTextColor` (`activeColor`), `borderColor`, `contentBgColor`, and `contentTextColor`.
267
+ - **Active Tab Bottom Indicator Line & Active Accordion Accent Bar:** Configure `indicatorColor` (active tab underline slider `.v-tab__slider` / `.el-tabs__active-bar` and open accordion header bottom accent border) and `indicatorHeight` (`2px`–`8px`), plus optional per-item `header.color` and `header.textColor` overrides.
207
268
 
208
269
  ---
209
270
 
210
- ## 5. Enterprise Survey & Poll Module (`survey`) + Strapi Analytics Hub
271
+ ## 6. Enterprise Survey & Poll Module (`survey`) + Strapi Analytics Hub
211
272
 
212
- The **`survey`** widget (15th built-in widget) provides a full-featured survey, NPS, and quick-poll platform with native Strapi reporting, statistical breakdowns, and anti-duplicate voting controls.
273
+ The **`survey`** widget provides a full-featured survey, NPS, and quick-poll platform with native Strapi reporting, statistical breakdowns, and anti-duplicate voting controls.
213
274
 
214
275
  ### 5.1 Three Display Modes (`displayMode`)
215
276
  1. **`quick_poll` (Quick Poll):** Compact single-card poll for 1-click voting and instant live `%` bar feedback.
@@ -272,31 +333,36 @@ Reporting is available in **two places** inside Strapi Admin:
272
333
 
273
334
  ---
274
335
 
275
- ## 6. Component Map Keys (`widget.id`) & Reference Table (All 15 Widgets)
336
+ ## 7. Component Map Keys (`widget.id`) & Reference Table (All 18 Widgets)
276
337
 
277
- All 15 built-in widgets use the following `widget.id` keys across the Strapi Visual Editor and both Nuxt storefront renderers (`@ozguraltan/strapi-content-input-nuxt-vuetify` and `@ozguraltan/strapi-content-input-nuxt-element-plus`):
338
+ All 18 built-in widgets use the following `widget.id` keys across the Strapi Visual Editor and both Nuxt storefront renderers (`@ozguraltan/strapi-content-input-nuxt-vuetify` and `@ozguraltan/strapi-content-input-nuxt-element-plus`):
278
339
 
279
340
  | Component Map Key (`widget.id`) | Category | `slotContext` Helper Property | Description & Supported Scenarios |
280
341
  | :--- | :--- | :--- | :--- |
342
+ | `heroSlider` | Media & Visuals | `widget.data`, `widget.options` | Homepage multi-layer **Swiper.js** hero banner (`CIHeroSlider`) with mouse drag-to-slide (`effect: 'slide'` default + `fade`/`creative`/`coverflow`/`cube`/`flip`), Ken Burns motion, Parallax layers (`badge`, `heading`, `subtitle`, `buttons`, `floating_image`, `stats`), and 7 typographic effects (`typewriter`, `gradient_text`, `rotating_words`, `highlight_marker`, `outline_stroke`, `glow`). |
343
+ | `dataTable` | Dynamic & Modules | `widget.data`, `widget.options` | Interactive **Data Table** (`CIDataTable`) supporting `.xlsx`/`.xls`/`.csv` file upload, Excel/CSV paste & live Strapi Collection (`GET /api/content-input/data-table`) with selectable fields, fixed/sticky header + X/Y scroll (`maxHeight`, `minTableWidth`, `stickyFirstColumn`), 9 column types, search, sorting, filter chips, pagination, summary row (`SUM`/`AVG`/`COUNT`), and CSV export. |
344
+ | `customCard` | Dynamic & Modules | `widget.data`, `widget.options` | **Custom Card Designer** (`CICustomCard`) with 6 archetypes (`feature`, `pricing` with ribbon & checklist, `testimonial` with stars, `profile`, `stat`, `overlay_story`), `heightMode` (`equal`/`fixed`/`auto`), per-card `accentOverride`, saved card design presets, Color Codes bindings, and `swiper` / `grid` / `single` display modes. |
345
+ | `entityCard` | Dynamic & Modules | `entityCardData` (`NormalizedEntityCardData`) | Linked Strapi entity card(s) supporting `'single'`, `'swiper'` (**Swiper.js Carousel**), and `'grid'` modes, `heightMode` (`equal`/`fixed`/`auto`), multi-entity `items[]` or automatic `collectionFeed`, field inheritance + per-card `accentColor` & manual overrides, and Color Codes `cardProps`. |
281
346
  | `HtmlEditor` | Content & Typography | `resolvedHtml` (`string`) | WYSIWYG rich HTML editor with source code view, media download link picker, transparent default background, and automatic `baseUrl` resolution for `/uploads/...` URLs. |
282
- | `heading` | Content & Typography | `headingData` (`{ text, tag, align, color, fontSize, fontWeight }`) | Semantic heading (`h1`–`h6`) with alignment (`left`, `center`, `right`), color, font size, and weight. |
283
- | `button` | Interactive & Navigation | `buttonData` (`{ label, url, target, variant, size, align }`) | CTA button supporting `primary`, `secondary`, `outline`, `ghost` variants and `sm`, `md`, `lg` sizes. |
347
+ | `heading` | Content & Typography | `headingData` (`{ text, tag, align, color, fontSize, fontWeight }`) | Semantic heading (`h1`–`h6`) with alignment (`left`, `center`, `right`), Color Codes / HEX / RGBA color, font size, and weight. |
348
+ | `button` | Interactive & Navigation | `buttonData` (`{ label, url, target, variant, size, align }`) | CTA button supporting `primary`, `secondary`, `outline`, `ghost` variants, custom Color Codes tokens, and `sm`, `md`, `lg` sizes. |
284
349
  | `singleImage` | Media & Visuals | `widget.data` (`{ image, alt, caption, link, objectFit, borderRadius, maxWidth }`) | Single image with caption, border radius, `cover`/`contain` mode, and optional external link. |
285
- | `spacer` | Layout | `widget.data` (`{ height, divider, dividerColor, lineWidth }`) | Configurable vertical space (`height` in `px`) with optional horizontal divider line. |
350
+ | `spacer` | Layout | `widget.data` (`{ height, divider, dividerColor, lineWidth }`) | Configurable vertical space (`height` in `px`) with optional Color Codes horizontal divider line. |
286
351
  | `gallery` | Media & Visuals | `galleryList` (`CIMediaAsset[]`) | **Swiper Carousel (`kind: 'swiper'`):** Official Swiper.js with mouse/touch drag, mousewheel, `slide`/`fade`/`cube`/`coverflow`/`flip` effects, `slidesPerView`, `spaceBetween`, `loop`, `autoplay`.<br>**Grid Gallery (`kind: 'gridGallery'`):** 5-breakpoint `itemsPerRow`, `aspectRatio`, `gridPadding`.<br>**Thumbnails vs Lightbox:** `sharp` `fit`/`widen` thumbnails in slides, **full-size original image** in Lightbox Popup. |
287
352
  | `youtubeVideo` | Media & Visuals | `ytData` (`{ videos, title, activeTitle, description, activeVideoId, thumb, isPopup, isThumbnailMode, iframeUrl, watchUrl }`) | Custom cover thumbnail (`customThumbnail`), hover animated Play button, Lightbox modal player (`popup: true`) with multi-video playlist, or inline card playback (`popup: false`). |
288
- | `tab` | Interactive & Navigation | `tabAccItems` (`NormalizedTabAccItem[]`) | Horizontal or vertical tabs (`options.vertical`, `options.grow`). Each tab supports both Rich HTML (`contentMode: 'text'`) and recursive nested `ContentInput` rows (`contentMode: 'builder'`). |
289
- | `accordion` | Interactive & Navigation | `tabAccItems` (`NormalizedTabAccItem[]`) | Single or multi-open (`options.multiple`) accordion panels with custom header colors (`header.color`, `header.textColor`), Rich HTML, and nested `ContentInput` rows. |
353
+ | `tab` | Interactive & Navigation | `tabAccItems` (`NormalizedTabAccItem[]`) | Horizontal or vertical tabs (`options.vertical`, `options.grow`) with Color Codes & `<CIColorField />` styling (`headerBgColor`, `headerTextColor`, `activeBgColor`, `activeTextColor`, active bottom line `indicatorColor` & `indicatorHeight`), Rich HTML (`contentMode: 'text'`), and recursive nested `ContentInput` rows (`contentMode: 'builder'`). |
354
+ | `accordion` | Interactive & Navigation | `tabAccItems` (`NormalizedTabAccItem[]`) | Single or multi-open (`options.multiple`) accordion panels with Color Codes & `<CIColorField />` styling (`headerBgColor`, `headerTextColor`, `activeBgColor`, `activeTextColor`, active bottom accent `indicatorColor`, per-node `header.color` / `header.textColor`), Rich HTML, and nested `ContentInput` rows. |
290
355
  | `menu` | Dynamic & Modules | `menuData` (`{ name, mode, items: CIMenuNodeItem[] }`) | Unlimited-depth hierarchical menu (`horizontal` dropdowns & `vertical` collapsible tree), reusable DB menu templates (`plugin::content-input.ci-menu`), and Strapi Collection-Type entity tree picker. |
291
356
  | `contentForm` | Dynamic & Modules | `formData`, `submitForm` | Async DB-backed dynamic form (`CIDynamicForm`) with 9 field types, dynamic Strapi `i18n` locales, shared client+server `vee-validate` rules, Google reCAPTCHA v2, Mailtrap/Mailgun/SMTP delivery, and `@submit-form` event. |
292
357
  | `survey` | Dynamic & Modules | `surveyData`, `submitSurvey` | Enterprise Survey & Quick Poll (`CISurvey`) supporting `quick_poll`, `single_page`, and `multi_step` wizard modes, 13 question types (NPS, Star, Likert, Matrix, Borda Ranking, Image Choice, etc.), conditional skip logic, HMAC duplicate protection, live `%` results, and `@submit-survey` event. |
293
- | `entityCard` | Dynamic & Modules | `entityCardData` (`NormalizedEntityCardData`) | Linked Strapi entity card (`vertical`, `horizontal`, `overlay` layouts) that auto-inherits entity fields (`title`, `description`, `image`, `url`) with optional per-field manual overrides and Vuetify/Element Plus `cardProps`. |
294
358
  | `iframe` | Media & Visuals | `widget.data` (`string` or `{ url, height }`) | Embedded iframe (OpenStreetMap, Google Maps, external embeds) with configurable height. |
295
359
  | `banner` | Media & Visuals | `widget.data` (`{ banner: { id, name } }`) | Campaign / promotional banner widget designed to be easily customized via slots or `:components`. |
296
360
 
297
361
  ---
298
362
 
299
- ## 7. Storefront Customization Guide (Nuxt Vuetify & Element Plus)
363
+ ## 8. Storefront Customization & Theme Props Guide (Nuxt Vuetify & Element Plus)
364
+
365
+ `<ContentInputPreview>` automatically fetches the active **Color Codes** palette (`GET ${baseUrl}/api/content-input/color-codes`) and binds `--ci-color-*` CSS variables on its root wrapper. You can also pass `:theme-slug="'emerald-fintech'"` or `:color-variables="{ '--ci-color-primary': '#059669' }"` to switch themes dynamically at runtime.
300
366
 
301
367
  Both `@ozguraltan/strapi-content-input-nuxt-vuetify` and `@ozguraltan/strapi-content-input-nuxt-element-plus` provide **3 ways** to customize widget rendering in your Nuxt 3/4 or Vue 3 application:
302
368
 
@@ -335,7 +401,7 @@ Pass an object mapping any `widget.id` key from the table above to your own Vue
335
401
  ```
336
402
 
337
403
  ### Method 3: CLI Template Ejection (`npx ... eject`)
338
- Copy the entire set of Vue SFC templates (`ContentInputPreview.vue`, `CIRow.vue`, `CIBlock.vue`, `CIWidget.vue`, `CIDynamicForm.vue`, `CISurvey.vue`) and utilities (`utils/helpers.ts`, `utils/formValidation.ts`, `utils/surveyHelpers.ts`) directly into your project so you can edit every line of template/CSS freely:
404
+ Copy the entire set of Vue SFC templates (`ContentInputPreview.vue`, `CIRow.vue`, `CIBlock.vue`, `CIWidget.vue`, `CISwiperNavButtons.vue`, `CIHeroSlider.vue`, `CIDataTable.vue`, `CICustomCard.vue`, `CIDynamicForm.vue`, `CISurvey.vue`) and utilities (`utils/helpers.ts`, `utils/colorCodes.ts`, `utils/formValidation.ts`, `utils/surveyHelpers.ts`) directly into your project so you can edit every line of template/CSS freely:
339
405
 
340
406
  ```bash
341
407
  # For Nuxt + Vuetify projects:
@@ -355,7 +421,7 @@ npx strapi-content-input-vuetify eject ./components/content-input --force
355
421
 
356
422
  ## 1. Mevcut Bir Strapi v5 Projesine Kurulum ve Entegrasyon
357
423
 
358
- `@ozguraltan/strapi-content-input`, gelişmiş **ContentInput** görsel sayfa/içerik tasarım motorunu, **Dinamik Form Oluşturucu Stüdyosunu (`contentForm`)**, **Kurumsal Anket & Raporlama Merkezini (`survey`)** ve **Strapi Entity Kartı (`entityCard`)** sistemini **Strapi v5** ekosistemine yerel bir `json` (`PostgreSQL JSONB`) özel alanı (**Custom Field**) olarak taşır.
424
+ `@ozguraltan/strapi-content-input`, gelişmiş **ContentInput** görsel sayfa/içerik tasarım motorunu (**18 yerleşik bileşen**), **Hero Slider**, **Veri Tabloları (`dataTable`)**, **Özel Kart Tasarımcısı (`customCard`)**, **Color Codes Tema Motorunu (`HEX` + `RGB/RGBA` + `--ci-color-*`)**, **Dinamik Form Stüdyosunu (`contentForm`)** ve **Kurumsal Anket & Raporlama Merkezini (`survey`)** **Strapi v5** ekosistemine yerel bir `json` (`PostgreSQL JSONB`) özel alanı (**Custom Field**) olarak taşır.
359
425
 
360
426
  ### Adım 1: Paketi Strapi Projenize Çekin
361
427
  ```bash
@@ -364,8 +430,9 @@ npm install @ozguraltan/strapi-content-input
364
430
  npm install git+ssh://git@gitlab.com:ozguraltan/strapi-content-input.git
365
431
  ```
366
432
 
367
- ### Adım 2: `config/plugins.ts` İçinde Etkinleştirin
433
+ ### Adım 2: `config/plugins.ts` ve `config/features.ts` İçinde Etkinleştirin
368
434
  ```ts
435
+ // config/plugins.ts
369
436
  export default () => ({
370
437
  'content-input': {
371
438
  enabled: true,
@@ -373,6 +440,14 @@ export default () => ({
373
440
  });
374
441
  ```
375
442
 
443
+ **Strapi v5.61+** sürümlerinde tüm ContentInput bileşenlerinde ve tam ekran stüdyolarda Strapi'nin kendi tam özellikli **Medya Kütüphanesi Modalının** (küçük resimler/thumbnails, sayfalama, klasör yönetimi, çoklu yükleme ve dahili kırpma/crop aracı ile) açılması için `config/features.ts` dosyasına `useLegacyMediaLibrary: true` ekleyin:
444
+ ```ts
445
+ // config/features.ts
446
+ export default () => ({
447
+ useLegacyMediaLibrary: true,
448
+ });
449
+ ```
450
+
376
451
  ### Adım 3: `schema.json` İçine Custom Field Olarak Ekleyin
377
452
  ```json
378
453
  {
@@ -426,19 +501,46 @@ export default () => ({
426
501
 
427
502
  ---
428
503
 
429
- ## 3. Bağlı İçerik Kartı (`entityCard`) — Otomatik Miras, Manuel Ezme ve Genel Kart Propları
504
+ ## 3. Bağlı İçerik Kartı (`entityCard`) — Tekli Kart, Swiper.js Carousel, Grid ve Otomatik Koleksiyon Akışı
430
505
 
431
- Yeni **`entityCard`** bileşeni herhangi bir Strapi içerik kaydına (`api::page.page`, makale, ürün vb.) bağlanır:
432
- - **Otomatik Miras (Fallback):** Editör kart üzerindeki Başlık (`title`), Alt Başlık (`subtitle`), Açıklama (`description`), Görsel (`image`), Rozet (`badgeText`) veya Link (`url`) alanlarını boş bıraktığında, bu bilgiler otomatik olarak bağlı olduğu Strapi kaydından çekilir (`ContentInput` JSON içeriğinden özet ve kapak görseli çıkarma dahil).
433
- - **Manuel Ezme (Override):** Editör istediği alanı doldurarak bağlı kayıttan gelen veriyi o kart özelinde ezebilir.
434
- - **Vuetify & Element Plus Kart Propları (`options.cardProps`):** `layout` (`vertical` dikey, `horizontal` yatay, `overlay` görsel üzeri kaplama), `variant` (`elevated`, `outlined`, `flat`, `tonal`), `elevation` (`0`–`24`), `rounded` (`0`, `sm`, `md`, `lg`, `xl`), `color`, `textColor`, `accentColor`, `imageHeight`, `showBadge`, `showButton`, `buttonVariant`, `hoverEffect`.
506
+ **`entityCard`** bileşeni herhangi bir Strapi içerik kaydına (`api::page.page`, makale, ürün vb.) bağlanır ve **3 farklı görünüm modunu** destekler:
507
+ - **Görünüm Modları (`options.displayMode`):** `'single'` (tek kart), `'swiper'` (resmi **Swiper.js Carousel** — `slidesPerView`, `spaceBetween`, `loop`, `autoplay`, `navigation`, `pagination`, `mousewheel`, `coverflow`/`cards` efektleri) ve `'grid'` (çok sütunlu duyarlı ızgara).
508
+ - **Çoklu Seçim (`items[]`) veya Otomatik Koleksiyon Akışı (`collectionFeed`):** Birden fazla Strapi kaydını elle seçip sıralayabilir veya bir Strapi koleksiyonundaki son `N` yayını (`GET /api/content-input/entity-cards`) otomatik olarak Swiper Carousel / Grid içinde listeleyebilirsiniz.
509
+ - **Otomatik Miras (Fallback), Kart Bazlı Accent Renk & Manuel Ezme (Override):** Editör kart üzerindeki Başlık (`title`), Alt Başlık (`subtitle`), Açıklama (`description`), Görsel (`image`), Rozet (`badgeText`), Link (`url`) veya kart bazlı Vurgu Rengi (`accentColor`) alanlarını boş bıraktığında bu bilgiler otomatik olarak bağlı Strapi kaydından/genel kart ayarından çekilir; doldurulan alanlar ise o kart özelinde ezilir.
510
+ - **Kart Carousel Düşey Yükseklik Eşitleme (`options.heightMode` & `options.cardHeight`):** Metin satır sayısı farklı olsa bile kartların boyunun kısalmaması için `'equal'` (varsayılan — en yüksek karta eşitler ve alt butonları aynı hizada sabitler), `'fixed'` (`cardHeight` piksel sabit yükseklik) ve `'auto'` seçeneklerini sunar.
511
+ - **Vuetify & Element Plus Kart Propları ve Color Codes (`options.cardProps`):** `layout` (`vertical`, `horizontal`, `overlay`), `variant` (`elevated`, `outlined`, `flat`, `tonal`), `elevation` (`0`–`24`), `rounded`, `color`, `textColor`, `accentColor` (Color Codes token destekli), `imageHeight`, `showBadge`, `showButton`, `buttonVariant`, `hoverEffect`.
435
512
  - **Dışarıdan Tam Özelleştirme:** `#widget-entityCard="{ entityCardData }"` slotu veya `:components="{ entityCard: BenimKartBilesenim }"` prop'u ile tamamen kendi kart tasarımınızı kullanabilirsiniz.
436
513
 
437
514
  ---
438
515
 
439
- ## 4. Kurumsal Anket & Oylama Modülü (`survey`) ve Strapi Raporlama Merkezi
516
+ ## 4. Color Codes Tema Motoru, Hero Slider, Veri Tabloları ve Özel Kart Tasarımcısı
517
+
518
+ 1. **Color Codes Tema Renk Yönetimi (`HEX` + `RGB/RGBA` + Görsel Spektrum + `--ci-color-*`):**
519
+ - Hem Strapi Sol Menüsündeki **Surveys, Forms & Colors -> Color Codes** sekmesinden hem de Görsel Editör üst çubuğundaki **🎨 Color Codes** butonundan yönetilir.
520
+ - `primary`, `secondary`, `accent`, `success`, `warning`, `error`, `info`, `surface`, `surfaceAlt`, `background`, `textPrimary`, `textSecondary`, `border` semantik renklerinin yanı sıra sınırsız sayıda özel marka rengi tanımlanabilir.
521
+ - Tüm renk alanlarında (`<CIColorField />`) **2D Görsel Renk Seçici**, doğrudan **`#HEX` (`#RRGGBB` / `#RRGGBBAA`)** girişi, sayısal **`RGB / RGBA` (`R`, `G`, `B`, `A%`)** kutuları + `rgb(...)`/`rgba(...)` metin girişi ve **"+ Bu Rengi Color Codes'a Kaydet"** özelliği bulunur. Aktif palet değiştiğinde bağlı tüm bileşenler (`var(--ci-color-primary, ...)`) sayfaları tek tek düzenlemeye gerek kalmadan anında güncellenir!
522
+ 2. **Hero Slider (`heroSlider` — Ölçekli Canlı Stüdyo, Serbest X/Y Katmanlar, 19+ Özel En-Boy Oranı ve Mobil Portrait Modu):**
523
+ - **Ölçekli Gerçek Viewport Sahnesi (`1280px` / `768px` / `390px` Mobil Portrait) ve Canlı Efekt Oynatımı:** Modal stüdyoda slaytları sıkıştırmak yerine gerçek hedef ekran genişliklerinde (`Fit`, `%50`, `%75`, `%100`, `# Grid`, `⤢ Zen`) ölçekleyerek birebir vitrin görünümüyle önizler; `◀ ▶`, `↻ Efektleri Oynat` ve `▶ Auto` ile tüm Swiper geçişlerini (`slide`, `fade`, `creative`, `coverflow`, `cube`, `flip`), Ken Burns ve tipografik efektleri canlı çalıştırır.
524
+ - **Serbest Katman Konumlandırma (`X, Y, Width, Height, Z-Index`):** Katmanları `Akış (Flow)` veya `Serbest (Free)` modda konumlandırın; sahne üzerinde fare ile sürükleyip 8 tutamaçla boyutlandırın, 9 noktalı hızlı hizalama matrisini kullanın ve masaüstü/tablet/mobil için ayrı kutu koordinatları (`box`, `boxTablet`, `boxMobile`) ve font boyutları tanımlayın.
525
+ - **19 Yaygın Aspect Ratio + Manuel Özel Oran (`W : H` / Piksel):** `4:1`'den `9:21`'e kadar kategorize 19 hazır en-boy oranı seçeneğinin yanı sıra `1920:680`, `2.35:1` gibi serbest manuel oran girişi hem Hero Slider (cihaz ve slayt bazlı) hem Galeri bileşeninde desteklenir.
526
+ - **Mobil Portrait Özel Slaytlar:** Cihaz bazlı slayt görünürlüğü (`all`, `desktop_tablet`, `mobile_only`, `desktop_only`, `tablet_only`), tek tıkla **"📱 Mobil Portrait Kopyası Türet"** aksiyonu ve mobil cihaza özel arka plan görseli/videosu (`mobileBgType` / `mobileBgImage`) ezme desteği sunar.
527
+ 3. **Veri Tabloları (`dataTable`):**
528
+ - **Excel (`.xlsx`, `.xls`) ve CSV (`.csv`, `.tsv`) Dosya Yükleme (Upload / Sürükle-Bırak)** (`xlsx` çoklu sayfa/sheet seçici ile), panodan yapıştırma (`manual`) veya **Canlı Strapi Koleksiyonu (`strapi_collection` -> `/api/content-input/data-table`)** veri kaynağıyla çalışır.
529
+ - Strapi koleksiyonu seçildiğinde koleksiyondaki **hangi alanların tabloya geleceği (`availableFields`)** onay kutularıyla seçilebilir ve sütun sırası/başlıkları özelleştirilebilir.
530
+ - **Sabit Tablo Başlığı (`stickyHeader`) + Yatay ve Düşey Scroll:** Düşey kaydırma (`verticalScroll` + `maxHeight`), yatay kaydırma (`horizontalScroll` + `minTableWidth`) ve ilk sütunu sabitleme (`stickyFirstColumn`) seçeneklerini destekler.
531
+ - `text`, `number`, `currency`, `progress` (yüzde çubuğu), `badge` (Color Codes rozetleri), `boolean`, `image` (tıklayınca büyüyen Lightbox), `date`, `link` hücre tiplerini; canlı arama, sütun sıralama, hızlı filtre çiplerini, sayfalamayı, alt toplam (`SUM`/`AVG`/`COUNT`) satırını ve ziyaretçi **CSV indirme** butonunu destekler.
532
+ 4. **Özel Kart Tasarımcısı (`customCard`):**
533
+ - **6 Hazır Kart Arketipi:** `feature` (Özellik/Hizmet), `pricing` (`"EN POPÜLER"` şeritli ve `✓` maddeli Fiyat Paketi), `testimonial` (5 yıldızlı Müşteri Yorumu), `profile` (Ekip Kartı), `stat` (KPI İstatistik Kartı), `overlay_story` (Görsel Üzeri Hikaye Kartı).
534
+ - **Düşey Yükseklik Eşitleme & Kart Bazlı Accent Renk:** `heightMode: 'equal' | 'fixed' | 'auto'` (`cardHeight` px) ile metin satır sayısına göre kartların kısalmasını engeller (en yüksek karta eşitler veya sabit yükseklik verir) ve her kart öğesi için ayrı **`accentOverride`** rengi seçilmesine olanak tanır.
535
+ - Köşe yuvarlatma, gölge/glassmorphism, hover efektleri (`lift`, `glow`, `scale`, `border-accent`), Color Codes bağlantıları ve tek tıkla **Kayıtlı Kart Tasarım Şablonu (`card_design`)** kaydetme/yükleme özellikleriyle birlikte `swiper` (Carousel), `grid` veya `single` olarak sergilenir.
536
+ 5. **Sekme (`tab`) ve Akordiyon (`accordion`) Color Codes & Renk Seçici Desteği:**
537
+ - Sekme ve akordiyon bileşenlerinde arka plan rengi (`headerBgColor`, `contentBgColor`), yazı rengi (`headerTextColor`, `contentTextColor`), aktif sekme/panel rengi (`activeBgColor`, `activeTextColor`) ve **aktif olan sekmenin altındaki çizgi rengi (`indicatorColor`) ile kalınlığı (`indicatorHeight`)** hem Color Codes token'ları hem de `#HEX` / `RGB/RGBA` renk seçici (`<CIColorField />`) ile düzenlenebilir.
440
538
 
441
- **`survey`** bileşeni (15. yerleşik bileşen); tek tıkla hızlı oylamalardan çok adımlı (Typeform tarzı) kurumsal anketlere, koşullu soru mantığından Strapi içi görsel analitik ve Excel dışa aktarımına kadar uçtan uca bir anket altyapısı sunar:
539
+ ---
540
+
541
+ ## 5. Kurumsal Anket & Oylama Modülü (`survey`) ve Strapi Raporlama Merkezi
542
+
543
+ **`survey`** bileşeni; tek tıkla hızlı oylamalardan çok adımlı (Typeform tarzı) kurumsal anketlere, koşullu soru mantığından Strapi içi görsel analitik ve Excel dışa aktarımına kadar uçtan uca bir anket altyapısı sunar:
442
544
 
443
545
  1. **3 Farklı Görünüm Modu (`displayMode`):**
444
546
  - `quick_poll`: Tek kartta hızlı oylama ve oy sonrası anlık `%` çubuk grafiği.
@@ -463,29 +565,32 @@ Yeni **`entityCard`** bileşeni herhangi bir Strapi içerik kaydına (`api::page
463
565
 
464
566
  ---
465
567
 
466
- ## 5. Bileşen Haritası Anahtarları (`widget.id` — Tüm 15 Bileşen)
568
+ ## 6. Bileşen Haritası Anahtarları (`widget.id` — Tüm 18 Bileşen)
467
569
 
468
570
  | Anahtar (`widget.id`) | Etiket | `slotContext` Verisi | Açıklama |
469
571
  | :--- | :--- | :--- | :--- |
572
+ | `heroSlider` | Hero Slider | `data`, `options` | Fare ile sürükle-bırak kaydırmalı (`slide` varsayılan) çok katmanlı **Swiper.js** ana sayfa banner alanı (`CIHeroSlider`), Ken Burns, Parallax ve 7 tipografik efekt (`typewriter`, `gradient_text`, `highlight_marker` vb.) |
573
+ | `dataTable` | Veri Tablosu | `data`, `options` | `.xlsx`/`.xls`/`.csv` dosya yükleme, yapıştırma veya alan seçilebilir canlı Strapi koleksiyon tablosu (`CIDataTable`); sabit başlık (`stickyHeader`), yatay/düşey scroll, ilk sütun sabitleme, 9 hücre formatı, arama, sıralama, filtre çipleri, alt toplam ve CSV indirme |
574
+ | `customCard` | Özel Kart Tasarımcısı | `data`, `options` | 6 arketipli (`feature`, `pricing`, `testimonial`, `profile`, `stat`, `overlay_story`) görsel kart stüdyosu (`CICustomCard`), düşey yükseklik eşitleme (`heightMode`), kart bazlı `accentOverride`, şablon kaydı ve `swiper` / `grid` / `single` gösterim |
575
+ | `entityCard` | İçerik Kartı / Carousel | `entityCardData` | Strapi kayıtlarından veri miras alan tekli kart, **Swiper.js Carousel (`swiper`)** veya `grid`; düşey yükseklik eşitleme (`heightMode`), kart bazlı `accentColor`, çoklu seçim (`items[]`) ve otomatik `collectionFeed` destekli |
470
576
  | `HtmlEditor` | Metin Editörü | `resolvedHtml` | WYSIWYG zengin metin, kaynak kodu, dosya indirme linki ve transparan arka plan |
471
- | `heading` | Başlık | `headingData` | `H1`–`H6` seviye, hizalama, boyut ve renk seçenekli başlık |
472
- | `button` | Buton | `buttonData` | `primary`, `secondary`, `outline`, `ghost` varyantlı ve `sm`/`md`/`lg` boyutlu aksiyon butonu |
473
- | `spacer` | Boşluk | `data` | Piksel yüksekliği ve isteğe bağlı ayırıcı çizgi (`divider: true`) |
577
+ | `heading` | Başlık | `headingData` | `H1`–`H6` seviye, hizalama, boyut ve Color Codes / HEX / RGBA renk seçenekli başlık |
578
+ | `button` | Buton | `buttonData` | `primary`, `secondary`, `outline`, `ghost` varyantlı, Color Codes renkli ve `sm`/`md`/`lg` boyutlu aksiyon butonu |
579
+ | `spacer` | Boşluk | `data` | Piksel yüksekliği ve isteğe bağlı Color Codes ayırıcı çizgi (`divider: true`) |
474
580
  | `singleImage` | Tek Görsel | `data` | Alt yazılı, köşe yuvarlatmalı (`borderRadius`) ve dış linkli görsel |
475
581
  | `gallery` | Galeri | `galleryList` | Resmi **Swiper.js** (`swiper`) veya çok sütunlu ızgara (`gridGallery`) + `sharp` thumbnail + tam boyutlu Lightbox Popup |
476
582
  | `youtubeVideo` | YouTube Video | `ytData` | Özel kapak görseli (`customThumbnail`), hover Play butonu, çoklu videolu Lightbox modal veya kart içi oynatıcı |
477
- | `tab` | Sekme (Tab) | `tabAccItems` | Yatay/Dikey sekmeler; zengin HTML ve iç içe (nested) `ContentInput` ızgarası |
478
- | `accordion` | Akordiyon | `tabAccItems` | Tekli/Çoklu açılır paneller; özel başlık renkleri, zengin HTML ve iç içe `ContentInput` ızgarası |
583
+ | `tab` | Sekme (Tab) | `tabAccItems` | Yatay/Dikey sekmeler; Color Codes & renk seçici ile arka plan, yazı, aktif sekme ve aktif alt çizgi rengi (`indicatorColor`/`indicatorHeight`), zengin HTML ve iç içe (nested) `ContentInput` ızgarası |
584
+ | `accordion` | Akordiyon | `tabAccItems` | Tekli/Çoklu açılır paneller; Color Codes & renk seçici ile başlık, yazı, aktif panel ve alt vurgu çizgisi rengi, zengin HTML ve iç içe `ContentInput` ızgarası |
479
585
  | `menu` | Menü | `menuData` | Yatay/Düşey sınırsız kırılımlı ağaç menü, DB şablon kaydı ve Strapi Entity ağaç seçici |
480
586
  | `contentForm` | Dinamik Form | `formData`, `submitForm` | PostgreSQL tabanlı dinamik form (`CIDynamicForm`), dinamik Strapi `i18n` dil desteği, `vee-validate` kuralları, reCAPTCHA v2 ve Mailtrap/Mailgun/SMTP gönderimi |
481
587
  | `survey` | Anket & Oylama | `surveyData`, `submitSurvey` | Çok adımlı sihirbaz / hızlı oylama (`CISurvey`), 13 soru tipi (NPS, Yıldız, Likert, Matris, Borda Sıralama, Görsel Seçim vb.), koşullu mantık, HMAC mükerrer oy engelleme ve canlı `%` sonuç grafikleri |
482
- | `entityCard` | İçerik Kartı | `entityCardData` | Strapi kaydından otomatik veri miras alan, alan bazlı ezilebilen ve Vuetify/Element Plus kart proplarını destekleyen kart |
483
588
  | `iframe` | Iframe | `data` | Harita veya harici sayfa yerleştirme (özelleştirilebilir yükseklik) |
484
589
  | `banner` | Banner | `data` | Kampanya ve tanıtım alanı (`#widget-banner` veya `:components="{ banner: MyBanner }"` ile özelleştirmeye hazır) |
485
590
 
486
591
  ### `npx` Komutu ile Nuxt Şablonlarını Projeye Kopyalama (`eject`)
487
592
  ```bash
488
- # Vuetify projeleri için (CIDynamicForm.vue, CISurvey.vue, formValidation.ts ve surveyHelpers.ts dahil tüm dosyaları kopyalar):
593
+ # Vuetify projeleri için (CIHeroSlider.vue, CIDataTable.vue, CICustomCard.vue, CIDynamicForm.vue, CISurvey.vue ve utils/colorCodes.ts dahil tüm dosyaları kopyalar):
489
594
  npx strapi-content-input-vuetify eject ./components/content-input
490
595
 
491
596
  # Element Plus projeleri için:
@@ -494,7 +599,9 @@ npx strapi-content-input-ep eject ./components/content-input
494
599
 
495
600
  ---
496
601
 
497
- ## 6. Lokal Geliştirme ve Playground Ortamları
602
+ ## 7. Lokal Geliştirme, GitLab CI/CD ve Playground Ortamları
603
+
604
+ > **Not (`dist/` ve GitLab CI/CD):** Derlenmiş `dist/` klasörü Git deposuna **push edilmez** (`.gitignore` içerisindedir). Paket GitLab CI/CD boru hattında (`.gitlab-ci.yml`) otomatik derlenir ve `git+ssh` kurulumlarında `package.json` içindeki `"prepare": "npm run build"` betiği sayesinde tüketici projede otomatik olarak inşa edilir.
498
605
 
499
606
  ```bash
500
607
  # 1. PostgreSQL veritabanını başlatın
@@ -3,21 +3,29 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
3
  const jsxRuntime = require("react/jsx-runtime");
4
4
  const React = require("react");
5
5
  const admin = require("@strapi/strapi/admin");
6
- const index = require("./index-B4FpXxnK.js");
7
- const SurveyWidgetEditor = require("./SurveyWidgetEditor-B3F4DE5r.js");
6
+ const index = require("./index-CZAwXCFH.js");
7
+ const SurveyWidgetEditor = require("./SurveyWidgetEditor-BmgYQaQS.js");
8
8
  const AnalyticsHubPage = () => {
9
9
  const { get, post } = admin.useFetchClient();
10
10
  const { locales: strapiLocales } = SurveyWidgetEditor.useStrapiLocales();
11
11
  const [uiLocale, setUiLocale] = React.useState(() => SurveyWidgetEditor.getInitialLocale());
12
12
  const tr = uiLocale === "tr";
13
- const [section, setSection] = React.useState("surveys");
13
+ const [section, setSection] = React.useState(() => {
14
+ try {
15
+ const sp = new URLSearchParams(window.location.search);
16
+ const tab = sp.get("tab");
17
+ if (tab === "colors" || tab === "forms" || tab === "surveys") return tab;
18
+ } catch {
19
+ }
20
+ return "surveys";
21
+ });
14
22
  const [surveys, setSurveys] = React.useState([]);
15
23
  const [selectedSurveySlug, setSelectedSurveySlug] = React.useState("showcase_dx_survey");
16
24
  const [analyticsRefreshKey, setAnalyticsRefreshKey] = React.useState(0);
17
25
  const [reseeding, setReseeding] = React.useState(false);
18
26
  const [studioOpen, setStudioOpen] = React.useState(false);
19
27
  const [studioTarget, setStudioTarget] = React.useState(
20
- () => SurveyWidgetEditor.createBlankSurveyDraft()
28
+ () => SurveyWidgetEditor.createBlankSurveyDraft(uiLocale)
21
29
  );
22
30
  const [forms, setForms] = React.useState([]);
23
31
  const [selectedFormSlug, setSelectedFormSlug] = React.useState("all");
@@ -152,7 +160,7 @@ const AnalyticsHubPage = () => {
152
160
  }
153
161
  ),
154
162
  /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
155
- /* @__PURE__ */ jsxRuntime.jsx("h1", { style: { margin: 0, fontSize: 20, fontWeight: 800, letterSpacing: "-0.01em" }, children: tr ? "ContentInput — Anket & Form Analitik Merkezi" : "ContentInput — Surveys & Forms Analytics Hub" }),
163
+ /* @__PURE__ */ jsxRuntime.jsx("h1", { style: { margin: 0, fontSize: 20, fontWeight: 800, letterSpacing: "-0.01em" }, children: tr ? "ContentInput — Anket, Form & Color Codes Merkezi" : "ContentInput — Surveys, Forms & Color Codes Hub" }),
156
164
  /* @__PURE__ */ jsxRuntime.jsx("div", { style: { fontSize: 12, color: "#cbd5e1", marginTop: 3 }, children: tr ? `${surveys.length} Aktif Anket • ${totalAllResponses} Toplam Anket Yanıtı • Strapi i18n Dilleri: ${strapiLocales.map((l) => l.code.toUpperCase()).join(", ")}` : `${surveys.length} Active Surveys • ${totalAllResponses} Total Survey Responses • Strapi i18n Locales: ${strapiLocales.map((l) => l.code.toUpperCase()).join(", ")}` })
157
165
  ] })
158
166
  ] }),
@@ -162,7 +170,7 @@ const AnalyticsHubPage = () => {
162
170
  {
163
171
  type: "button",
164
172
  onClick: () => {
165
- setStudioTarget(SurveyWidgetEditor.createBlankSurveyDraft());
173
+ setStudioTarget(SurveyWidgetEditor.createBlankSurveyDraft(uiLocale));
166
174
  setStudioOpen(true);
167
175
  },
168
176
  style: {
@@ -219,7 +227,7 @@ const AnalyticsHubPage = () => {
219
227
  overflow: "hidden",
220
228
  border: "1px solid rgba(255,255,255,0.25)"
221
229
  },
222
- children: ["tr", "en"].map((loc) => /* @__PURE__ */ jsxRuntime.jsx(
230
+ children: ["en", "tr"].map((loc) => /* @__PURE__ */ jsxRuntime.jsx(
223
231
  "button",
224
232
  {
225
233
  type: "button",
@@ -315,11 +323,54 @@ const AnalyticsHubPage = () => {
315
323
  /* @__PURE__ */ jsxRuntime.jsx("span", { children: tr ? "Dinamik Form Başvuruları" : "Dynamic Form Submissions" })
316
324
  ]
317
325
  }
326
+ ),
327
+ /* @__PURE__ */ jsxRuntime.jsxs(
328
+ "button",
329
+ {
330
+ type: "button",
331
+ onClick: () => setSection("colors"),
332
+ style: {
333
+ padding: "13px 18px",
334
+ border: "none",
335
+ borderBottom: section === "colors" ? "3px solid #2563eb" : "3px solid transparent",
336
+ background: "transparent",
337
+ color: section === "colors" ? "#1d4ed8" : "#475569",
338
+ fontSize: 13,
339
+ fontWeight: 700,
340
+ cursor: "pointer",
341
+ display: "inline-flex",
342
+ alignItems: "center",
343
+ gap: 7
344
+ },
345
+ children: [
346
+ /* @__PURE__ */ jsxRuntime.jsx(
347
+ index.MaterialIcon,
348
+ {
349
+ name: "palette",
350
+ size: 17,
351
+ color: section === "colors" ? "#2563eb" : "#64748b"
352
+ }
353
+ ),
354
+ /* @__PURE__ */ jsxRuntime.jsx("span", { children: tr ? "Color Codes & Tema Renkleri" : "Color Codes & Theme Palettes" })
355
+ ]
356
+ }
318
357
  )
319
358
  ]
320
359
  }
321
360
  ),
322
- section === "surveys" ? /* @__PURE__ */ jsxRuntime.jsxs(
361
+ section === "colors" ? /* @__PURE__ */ jsxRuntime.jsx("div", { style: { padding: "22px 28px" }, children: /* @__PURE__ */ jsxRuntime.jsx(
362
+ "div",
363
+ {
364
+ style: {
365
+ background: "#ffffff",
366
+ borderRadius: 14,
367
+ border: "1px solid #cbd5e1",
368
+ padding: 20,
369
+ boxShadow: "0 4px 18px rgba(15, 23, 42, 0.04)"
370
+ },
371
+ children: /* @__PURE__ */ jsxRuntime.jsx(SurveyWidgetEditor.ColorCodesManager, { locale: uiLocale })
372
+ }
373
+ ) }) : section === "surveys" ? /* @__PURE__ */ jsxRuntime.jsxs(
323
374
  "div",
324
375
  {
325
376
  style: {
@@ -389,7 +440,7 @@ const AnalyticsHubPage = () => {
389
440
  ]
390
441
  }
391
442
  ),
392
- /* @__PURE__ */ jsxRuntime.jsx("div", { style: { fontSize: 13, fontWeight: 700, color: "#0f172a" }, children: srv.title }),
443
+ /* @__PURE__ */ jsxRuntime.jsx("div", { style: { fontSize: 13, fontWeight: 700, color: "#0f172a" }, children: SurveyWidgetEditor.pickTextForLocale(srv.titleI18n, uiLocale, srv.title) }),
393
444
  /* @__PURE__ */ jsxRuntime.jsxs(
394
445
  "div",
395
446
  {