strapi-plugin-copy-any-component 1.0.0

package/INSTALLATION.md

@@ -0,0 +1,179 @@
+# Component Copy Plugin - Kurulum Rehberi
+
+Bu rehber, Component Copy plugin'ini başka bir Strapi projesinde kullanmak için gerekli adımları içerir.
+
+## Önkoşullar
+
+- Strapi 5.0.0 veya üzeri
+- Node.js 20.x veya üzeri
+- Mevcut bir Page content type'ı (sections dynamic zone ile)
+
+## Kurulum Adımları
+
+### 1. Plugin'i Kopyalayın
+
+Plugin klasörünü hedef Strapi projenizin `src/plugins/` dizinine kopyalayın:
+
+```bash
+# Mevcut projeden
+cp -r /path/to/source/strapi/src/plugins/my-simple-plugin /path/to/target/strapi/src/plugins/
+
+# veya Git kullanarak
+git clone <repository-url> /path/to/target/strapi/src/plugins/my-simple-plugin
+```
+
+### 2. Plugin'i Kaydedin
+
+Hedef projede `config/plugins.ts` dosyasını düzenleyin:
+
+```typescript
+export default () => ({
+  'my-simple-plugin': {
+    enabled: true,
+    resolve: './src/plugins/my-simple-plugin',
+  },
+});
+```
+
+Eğer `config/plugins.js` kullanıyorsanız:
+
+```javascript
+module.exports = {
+  'my-simple-plugin': {
+    enabled: true,
+    resolve: './src/plugins/my-simple-plugin',
+  },
+};
+```
+
+### 3. Gerekli Content Type'ı Kontrol Edin
+
+Plugin, `api::page.page` content type'ını kullanır. Bu content type'ın şu özelliklere sahip olması gerekir:
+
+- **Dynamic Zone**: `sections` adında bir dynamic zone field
+- **Slug**: Sayfaları tanımlamak için slug field'ı
+
+Eğer farklı bir content type kullanıyorsanız, plugin kodunu düzenlemeniz gerekebilir.
+
+#### Örnek Page Schema:
+
+```json
+{
+  "kind": "collectionType",
+  "collectionName": "pages",
+  "info": {
+    "singularName": "page",
+    "pluralName": "pages",
+    "displayName": "Page"
+  },
+  "attributes": {
+    "title": {
+      "type": "string",
+      "required": true
+    },
+    "slug": {
+      "type": "uid",
+      "targetField": "title",
+      "required": true
+    },
+    "sections": {
+      "type": "dynamiczone",
+      "components": [
+        // Component listesi buraya gelecek
+      ]
+    }
+  }
+}
+```
+
+### 4. İzinleri Ayarlayın
+
+Strapi admin panelinde şu adımları izleyin:
+
+1. **Settings > Users & Permissions > Roles** sayfasına gidin
+2. İlgili role'ü seçin (örn: Authenticated, Public)
+3. **My Simple Plugin** bölümünü bulun
+4. Şu izinleri etkinleştirin:
+   - `find` - Sayfaları listelemek için
+   - `getPageSections` - Section'ları görmek için
+   - `copySections` - Component'leri kopyalamak için
+   - `updatePageSections` - Section'ları güncellemek için
+   - `publish` - Sayfaları yayınlamak için
+
+### 5. Strapi'yi Yeniden Başlatın
+
+```bash
+npm run develop
+# veya production için
+npm run build
+npm run start
+```
+
+### 6. Plugin'i Kullanın
+
+1. Strapi admin panelinde **Plugins** menüsüne gidin
+2. **Component Copy** seçeneğini bulun
+3. Plugin arayüzünü kullanarak component'leri kopyalayın
+
+## Farklı Content Type Kullanımı
+
+Eğer `page` yerine farklı bir content type kullanıyorsanız (örneğin `article`, `post`), plugin kodunda aşağıdaki dosyaları güncellemeniz gerekir:
+
+1. `server/src/services/component-copy.js` - Tüm `api::page.page` referanslarını değiştirin
+2. `strapi-server.js` - Controller'lardaki `api::page.page` referanslarını değiştirin
+3. `admin/src/pages/HomePage.jsx` - API endpoint'lerini kontrol edin (genellikle değişmez)
+
+**Örnek değişiklik:**
+
+```javascript
+// Eski
+await strapi.entityService.findOne("api::page.page", pageId, ...)
+
+// Yeni (article için)
+await strapi.entityService.findOne("api::article.article", pageId, ...)
+```
+
+## Sorun Giderme
+
+### Plugin görünmüyor
+
+- `config/plugins.ts` dosyasının doğru yapılandırıldığından emin olun
+- Strapi'yi yeniden başlatın
+- `dist` klasörünü temizleyin: `rm -rf dist .cache`
+
+### "Page not found" hatası
+
+- Page content type'ının doğru şekilde oluşturulduğundan emin olun
+- Slug field'ının mevcut olduğunu kontrol edin
+- Sections dynamic zone'ın tanımlı olduğunu doğrulayın
+
+### Component'ler kopyalanmıyor
+
+- İzinlerin doğru ayarlandığından emin olun
+- Browser console'da hata mesajlarını kontrol edin
+- Network tab'inde API isteklerinin başarılı olduğunu doğrulayın
+
+### Media dosyaları kopyalanmıyor
+
+- Media library'de dosyaların mevcut olduğundan emin olun
+- Media field'larının populate edildiğinden emin olun
+- Component schema'larında media field'larının doğru tanımlandığını kontrol edin
+
+## Önemli Notlar
+
+1. **Bootstrap Fonksiyonu**: Mevcut projedeki `src/index.ts` dosyasında bootstrap kodu varsa, bu kod hedef projede çalışmayabilir. Bootstrap kodunu yalnızca test/development için kullanıyorsanız, production'da kaldırmak isteyebilirsiniz.
+
+2. **Component'ler**: Plugin, dynamic zone içindeki tüm component'leri destekler. Kendi component'lerinizi kullanabilirsiniz.
+
+3. **Performance**: Çok sayıda component'i kopyalarken performans etkilenebilir. Büyük component'ler için dikkatli olun.
+
+4. **Backup**: Component kopyalama işleminden önce veritabanınızı yedeklemeyi unutmayın.
+
+## Destek
+
+Sorun yaşarsanız:
+1. Browser console'da hata mesajlarını kontrol edin
+2. Strapi log'larını inceleyin
+3. Plugin'in doğru kurulduğundan emin olun
+4. İzinlerin ayarlandığını doğrulayın
+

package/QUICK_START.md

@@ -0,0 +1,88 @@
+# Component Copy Plugin - Hızlı Başlangıç
+
+## ✅ Kurulum Checklist
+
+Başka bir Strapi projesinde plugin'i kullanmak için şu adımları izleyin:
+
+### 1. Plugin'i Kopyalayın
+
+```bash
+# Mevcut projeden plugin klasörünü kopyalayın
+cp -r /path/to/source/strapi/src/plugins/my-simple-plugin /path/to/target/strapi/src/plugins/
+```
+
+### 2. Plugin'i Kaydedin
+
+`config/plugins.ts` dosyasına ekleyin:
+
+```typescript
+export default () => ({
+  'my-simple-plugin': {
+    enabled: true,
+    resolve: './src/plugins/my-simple-plugin',
+  },
+});
+```
+
+### 3. İzinleri Ayarlayın
+
+Strapi admin panelinde:
+- **Settings > Users & Permissions > Roles**
+- İlgili role seçin (Authenticated, Public, vb.)
+- **My Simple Plugin** bölümündeki tüm izinleri etkinleştirin:
+  - `find`
+  - `getPageSections`
+  - `copySections`
+  - `updatePageSections`
+  - `publish`
+
+### 4. Strapi'yi Yeniden Başlatın
+
+```bash
+# Development
+npm run develop
+
+# Production
+npm run build
+npm run start
+```
+
+### 5. Plugin'i Kullanın
+
+- Admin panelinde **Plugins > Component Copy** menüsüne gidin
+- Component'leri kopyalayın ve sıralayın
+
+## ⚠️ Önemli Notlar
+
+1. **Page Content Type Gerekli**: Plugin `api::page.page` content type'ını kullanır. Bu content type'ın:
+   - `sections` adında bir dynamic zone field'ı olmalıdır
+   - `slug` field'ı olmalıdır
+
+2. **Farklı Content Type**: Eğer farklı bir content type kullanıyorsanız, plugin kodunda `api::page.page` referanslarını değiştirmeniz gerekir.
+
+3. **Bootstrap Kodu**: Mevcut projedeki `src/index.ts` dosyasındaki bootstrap kodu bu plugin'e özel değildir. İsterseniz hedef projede kullanmayabilirsiniz.
+
+4. **Component'ler**: Plugin herhangi bir dynamic zone component'ini destekler. Kendi component'lerinizi kullanabilirsiniz.
+
+## 🔧 Farklı Content Type Kullanımı
+
+Eğer `page` yerine başka bir content type kullanıyorsanız:
+
+1. `server/src/services/component-copy.js` dosyasında tüm `api::page.page` referanslarını değiştirin
+2. `strapi-server.js` dosyasında controller'lardaki `api::page.page` referanslarını değiştirin
+
+**Örnek:**
+```javascript
+// Eski
+api::page.page
+
+// Yeni (örneğin article için)
+api::article.article
+```
+
+## 📚 Daha Fazla Bilgi
+
+- **Detaylı Kurulum**: [INSTALLATION.md](./INSTALLATION.md)
+- **Kullanım Rehberi**: [USAGE.md](./USAGE.md)
+- **Genel Bilgiler**: [README.md](./README.md)
+

package/README.md

@@ -0,0 +1,165 @@
+# Copy Any Component Plugin for Strapi 5
+
+[![npm version](https://img.shields.io/npm/v/@strapi/plugin-copy-any-component.svg)](https://www.npmjs.com/package/@strapi/plugin-copy-any-component)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A powerful Strapi plugin that allows you to copy and reorder components (sections) between pages using an intuitive drag-and-drop interface. **No code required!** Works with any content type and dynamic zone.
+
+## ✨ Features
+
+- 🎯 **Drag & Drop Interface**: Intuitive visual interface for copying components
+- 📋 **Component Copying**: Copy components from one page to another
+- 🔄 **Component Reordering**: Reorder components within a page
+- 🔍 **Auto-Detection**: Automatically detects all content types and dynamic zones
+- ⚙️ **Zero-Code Configuration**: Configure via admin panel - settings persist across restarts
+- 📸 **Media Support**: Properly handles media files and images
+- 💾 **Draft/Publish System**: Changes are saved as drafts, publish when ready
+- ✅ **Detailed Feedback**: See exactly what fields and media were copied
+- 🌐 **Universal**: Works with any content type (Page, Article, Blog, etc.) and any dynamic zone field
+
+## 🔍 Automatic Content Type Detection
+
+This plugin works with **any content type** and **any dynamic zone**! The plugin automatically:
+
+- Detects all custom content types (Page, Article, Blog, LandingPage, etc.)
+- Finds all fields containing dynamic zones (sections, blocks, content, etc.)
+- Provides a dropdown interface in the admin panel for easy selection
+
+### Admin Panel Configuration (No Code Required!)
+
+1. Go to the plugin page
+2. Click the **⚙️ Content Type Settings** button in the top right
+3. Select your desired **Content Type** and **Dynamic Zone**
+4. Click **💾 Save**
+
+Settings are **automatically saved** and persist even after Strapi restarts! No need to edit code.
+
+## 📖 Documentation
+
+- **[QUICK_START.md](./QUICK_START.md)** - Hızlı başlangıç rehberi (önerilen)
+- **[INSTALLATION.md](./INSTALLATION.md)** - Detaylı kurulum rehberi
+- **[USAGE.md](./USAGE.md)** - Kullanım rehberi ve örnekler
+- **[TESTING.md](./TESTING.md)** - Test rehberi
+
+## ✨ Features
+
+- 🎯 **Drag & Drop Interface**: Intuitive visual interface for copying components
+- 📋 **Component Copying**: Copy components from one page to another
+- 🔄 **Component Reordering**: Reorder components within a page
+- 🔍 **Auto-Detection**: Automatically detects all content types and dynamic zones
+- ⚙️ **Zero-Code Configuration**: Configure via admin panel - settings persist across restarts
+- 📸 **Media Support**: Properly handles media files and images
+- 💾 **Draft/Publish System**: Changes are saved as drafts, publish when ready
+- ✅ **Detailed Feedback**: See exactly what fields and media were copied
+- 🌐 **Universal**: Works with any content type (Page, Article, Blog, etc.) and any dynamic zone field
+
+## 📦 Installation
+
+### NPM Install (Recommended)
+
+```bash
+npm install @strapi/plugin-copy-any-component
+```
+
+### Manual Install
+
+1. **Install the plugin:**
+   ```bash
+   npm install @strapi/plugin-copy-any-component
+   ```
+
+2. **Register the plugin** in `config/plugins.ts`:
+   ```typescript
+   export default () => ({
+     'copy-any-component': {
+       enabled: true,
+       resolve: './node_modules/@strapi/plugin-copy-any-component',
+       // Optional: Set defaults (can be changed via admin panel)
+       config: {
+         contentType: 'api::page.page',
+         dynamicZoneField: 'sections',
+       },
+     },
+   });
+   ```
+
+3. **Set permissions:**
+   - Go to **Settings > Users & Permissions > Roles** in Strapi admin
+   - Enable permissions for **Copy Any Component** section:
+     - Access Component Copy pages
+     - Copy components
+     - Update page sections
+     - Publish pages
+
+4. **Restart Strapi:**
+   ```bash
+   npm run develop
+   ```
+
+### Configuration
+
+The plugin can be configured in two ways:
+
+1. **Via Admin Panel (Recommended)**: No code required! Settings persist automatically.
+2. **Via Config File**: Edit `config/plugins.ts` as shown above.
+
+For detailed installation instructions, see [INSTALLATION.md](./INSTALLATION.md).
+
+## 🚀 Usage
+
+For detailed usage instructions, see [USAGE.md](./USAGE.md).
+
+### Basic Usage
+
+1. Go to **Plugins > Copy Any Component** in Strapi admin panel
+2. **Source Page** (left panel) - Select the page you want to copy components from
+3. **Target Page** (right panel) - Select the page you want to copy components to
+4. Drag components from Source Page and drop them on Target Page
+5. Reorder components in Target Page by dragging them
+6. Click **Publish** to save changes
+
+### Configuration via Admin Panel
+
+1. Click **⚙️ Content Type Settings** button in the plugin page
+2. Select your **Content Type** (e.g., Page, Article, Blog)
+3. Select your **Dynamic Zone Field** (e.g., sections, blocks, content)
+4. Click **💾 Save** - settings persist automatically!
+
+## 🔌 API Endpoints
+
+### Admin Routes
+
+- `GET /admin/plugins/copy-any-component/pages` - List all pages
+- `GET /admin/plugins/copy-any-component/pages/:pageId/sections` - Get page sections
+- `GET /admin/plugins/copy-any-component/content-types` - List available content types
+- `PUT /admin/plugins/copy-any-component/config` - Update plugin configuration
+- `POST /admin/plugins/copy-any-component/pages/:sourcePageId/copy-to/:targetPageId` - Copy sections
+- `PUT /admin/plugins/copy-any-component/pages/:pageId/sections` - Update page sections (reorder)
+- `POST /admin/plugins/copy-any-component/pages/:pageId/publish` - Publish page
+
+### Content API Routes
+
+- `GET /api/copy-any-component/pages/:pageId/sections` - Get page sections
+- `POST /api/copy-any-component/pages/:sourcePageId/copy-to/:targetPageId` - Copy sections
+
+## Permissions
+
+Make sure to grant permissions in **Settings > Users & Permissions > Roles**:
+- Access Component Copy pages
+- Copy components
+- Update page sections
+- Publish pages
+
+## Requirements
+
+- Strapi 5.0.0 or higher
+- Node.js 20.x or higher
+
+## License
+
+MIT
+
+## Support
+
+For issues and questions, please open an issue on GitHub.
+

package/TESTING.md

@@ -0,0 +1,193 @@
+# Copy Any Component Plugin - Test Rehberi
+
+Bu rehber, plugin'i test etmek için adım adım talimatlar içerir.
+
+## 1. Temel Test
+
+### Adım 1: Strapi'yi Başlatın
+
+```bash
+npm run develop
+```
+
+### Adım 2: Admin Panelinde Plugin'e Erişin
+
+1. Strapi admin panelinde giriş yapın
+2. Sol menüden **Plugins > Copy Any Component 🎨** seçeneğine tıklayın
+
+### Adım 3: Sayfaları Kontrol Edin
+
+- Source Page (sol panel) ve Target Page (sağ panel) dropdown'larından sayfaları görebilmelisiniz
+- Eğer sayfa yoksa, önce Content Manager'da birkaç sayfa oluşturun
+
+### Adım 4: Component Kopyalama Testi
+
+1. **Source Page** seçin (örneğin: "Ana Sayfa")
+2. **Target Page** seçin (örneğin: "Hakkımızda")
+3. Source Page panelinden bir component'i seçin
+4. Component'i sürükleyip Target Page paneline bırakın
+5. Başarı mesajını görmelisiniz
+6. Target Page panelinde yeni component görünmeli
+
+### Adım 5: Kopyalanan Component'i Kontrol Edin
+
+1. Content Manager > Pages > Target Page'e gidin
+2. Sayfayı düzenle modunda açın
+3. Kopyalanan component'in tüm field'larının doğru kopyalandığını kontrol edin:
+   - Text field'lar
+   - Media dosyaları
+   - Nested component'ler (button, form-field, vb.)
+   - Relation field'lar
+
+### Adım 6: Publish Testi
+
+1. Plugin arayüzüne geri dönün
+2. **Publish** butonuna tıklayın
+3. Başarı mesajını görmelisiniz
+4. Frontend'de değişikliklerin göründüğünü kontrol edin
+
+## 2. Farklı Component Tipleri Testi
+
+Her component tipini test edin:
+
+- ✅ **Hero Section** - Basit component
+- ✅ **CTA Section** - Button component'leri içeren
+- ✅ **Stats Section** - Relation (siteSettings) içeren
+- ✅ **Form Section** - Nested form-field component'leri içeren
+- ✅ **Gallery Section** - Media array içeren
+- ✅ **Accordion Section** - Nested accordion-item component'leri içeren
+- ✅ **Pricing Section** - Nested pricing-plan component'leri içeren
+- ✅ **Timeline Section** - Nested timeline-item component'leri içeren
+
+Her bir component tipinde:
+- Tüm field'ların kopyalandığını doğrulayın
+- Nested component'lerin kopyalandığını doğrulayın
+- Media dosyalarının referanslarının korunduğunu doğrulayın
+
+## 3. Aynı Sayfada Kopyalama Testi
+
+1. Aynı sayfayı hem Source hem de Target olarak seçin
+2. Bir component'i kopyalayın
+3. Component'in duplicate (çoğaltıldığını) doğrulayın
+4. Publish edin ve sonucu kontrol edin
+
+## 4. Component Sıralama Testi
+
+1. Target Page panelinde component'leri seçin
+2. Component'leri sürükleyerek sıralayın
+3. Değişikliklerin otomatik kaydedildiğini kontrol edin
+4. Publish edin ve sonucu kontrol edin
+
+## 5. Farklı Content Type Testi (OPSİYONEL)
+
+Eğer farklı bir content type kullanmak istiyorsanız:
+
+### Adım 1: Config'i Güncelleyin
+
+`config/plugins.ts` dosyasını düzenleyin:
+
+```typescript
+export default () => ({
+  'copy-any-component': {
+    enabled: true,
+    resolve: './src/plugins/my-simple-plugin',
+    config: {
+      contentType: 'api::article.article',  // Farklı content type
+      dynamicZoneField: 'blocks',            // Farklı field name
+    },
+  },
+});
+```
+
+### Adım 2: Strapi'yi Yeniden Başlatın
+
+```bash
+npm run develop
+```
+
+### Adım 3: Yeni Content Type ile Test Edin
+
+1. Content Manager'da yeni content type'dan kayıtlar oluşturun
+2. Plugin arayüzünde yeni kayıtları görebilmelisiniz
+3. Component kopyalama işlemini test edin
+
+## 6. Hata Senaryoları Testi
+
+### Test 1: İzin Hatası
+
+1. Gerekli izinleri kapatın (Settings > Users & Permissions > Roles)
+2. Component kopyalamayı deneyin
+3. Uygun hata mesajını görmelisiniz
+
+### Test 2: Geçersiz Sayfa ID
+
+1. Network tab'ını açın
+2. Component kopyalama işlemini başlatın
+3. API request'ini düzenleyip geçersiz ID gönderin
+4. Uygun hata mesajını görmelisiniz
+
+## 7. Performance Testi
+
+1. Çok sayıda component içeren bir sayfa oluşturun (10+ component)
+2. Tüm component'leri tek tek kopyalayın
+3. İşlemlerin makul bir sürede tamamlandığını kontrol edin
+
+## 8. Browser Console Testi
+
+1. Browser Developer Tools'u açın (F12)
+2. Console tab'ına geçin
+3. Component kopyalama işlemini yapın
+4. Herhangi bir JavaScript hatası olmadığını doğrulayın
+5. Network tab'ında API isteklerinin başarılı olduğunu kontrol edin
+
+## 9. Detaylı Bilgi Modal Testi
+
+1. Bir component'i kopyalayın
+2. Başarı mesajına tıklayın
+3. Detaylı bilgi modal'ının açıldığını kontrol edin
+4. Şu bilgileri doğrulayın:
+   - Kopyalanan field sayısı
+   - Media dosyaları
+   - Kaldırılan sistem field'ları (id, createdAt, vb.)
+
+## 10. Frontend Render Testi
+
+1. Component'leri kopyalayın ve publish edin
+2. Frontend'de sayfayı açın
+3. Tüm component'lerin doğru render edildiğini kontrol edin:
+   - Stil'ler doğru mu?
+   - İçerik doğru mu?
+   - Media dosyaları görünüyor mu?
+   - Nested component'ler çalışıyor mu?
+
+## Beklenen Sonuçlar
+
+✅ **Başarılı Senaryolar:**
+- Component'ler sorunsuz kopyalanır
+- Tüm field'lar korunur
+- Media referansları korunur
+- Nested component'ler kopyalanır
+- Publish işlemi başarılı olur
+
+❌ **Hata Senaryoları:**
+- İzin hatası mesajı gösterilir
+- Geçersiz sayfa hatası gösterilir
+- Network hataları uygun şekilde handle edilir
+
+## Sorun Giderme
+
+### Component'ler görünmüyor
+- Sayfaların publish edildiğinden emin olun
+- Browser cache'ini temizleyin
+- Strapi'yi yeniden başlatın
+
+### Component kopyalanmıyor
+- Browser console'da hata var mı kontrol edin
+- Network tab'ında API isteklerini kontrol edin
+- İzinlerin doğru ayarlandığını kontrol edin
+
+### Field'lar kayboluyor
+- Browser console log'larını kontrol edin
+- Component schema'sını kontrol edin
+- Media field'larının doğru populate edildiğinden emin olun
+