# Developer Wiki

> Guides for writing FluxWP plugins and themes, AI-enabled features and the shared platform.

Add .md to any page address to get its Markdown. The whole wiki in one file: https://fluxwp.com/wiki/llms-full.txt

## Başlangıç

- [FluxWP nedir?](https://fluxwp.com/wiki/fluxwp-nedir.md): FluxWP; WordPress için tek elden yönetilen eklenti, tema ve uygulama ailesidir. Bu sayfa repoları, paketleri ve ortak kuralları özetler.
- [Adlandırma kuralları](https://fluxwp.com/wiki/adlandirma.md): Paket kısa adı, görünen ad, kod öneki, hook, REST ad alanı, option ve MCP araç adları için FluxWP kuralları.
- [Bu wiki nasıl kullanılır?](https://fluxwp.com/wiki/wiki-kullanimi.md): Flux Wiki'de arama, Markdown yazımı, wiki bağlantıları, not kutuları, LLM için .md ve llms.txt adresleri ve MCP araçları.

## Eklenti geliştirme

- [Yeni eklenti yazma](https://fluxwp.com/wiki/eklenti-yazma.md): Sıfırdan bir FluxWP eklentisi: klasör yapısı, ana dosya başlığı, sabitler, çeviri yükleyici, marka modülü, ikon ve paket dosyaları.
  - [Ayarlar ve ayar şeması](https://fluxwp.com/wiki/eklenti-yazma/ayarlar.md): Ayarlar panelden girilir, tek option dizisinde saklanır ve flx_settings_schema ile ön ayar ve AI'ye tanıtılır.
  - [Çeviri ve tarih](https://fluxwp.com/wiki/eklenti-yazma/ceviri.md): Kaynak dil Türkçe, İngilizce çeviri pakette; genstr.py ile .pot/.po/.mo üretimi, JS metinleri ve flx_date / flx_time_ago.
  - [Flux Admin entegrasyonu](https://fluxwp.com/wiki/eklenti-yazma/flux-admin.md): Sayfa başlığı, menü logosu, menü grubu, uygulama kısayolu ve güncelleme ekranı logosu için filtreler.
  - [Sistem kontrolü](https://fluxwp.com/wiki/eklenti-yazma/sistem-kontrolu.md): Her paket kendi sağlık satırlarını flx_system_checks ile ortak Sistem kontrolü ekranına ekler.

## AI ve MCP

- [Eklentiyi AI destekli yapmak](https://fluxwp.com/wiki/ai-destekli-eklenti.md): AI kullanan her FluxWP eklentisi Flux AI üzerinden geçer; flxai_chat, flxai_ready, kaynak kaydı, hatalar ve yedek kod.
  - [MCP aracı yazmak](https://fluxwp.com/wiki/ai-destekli-eklenti/mcp-araci-yazma.md): flx_mcp_tools ile eklentinizin işlevlerini Flux AI sohbetine ve dış MCP istemcilerine (Claude, Cursor) açın; kaynak ve istem ekleyin.
  - [AI için iyi uygulamalar](https://fluxwp.com/wiki/ai-destekli-eklenti/iyi-uygulamalar.md): Maliyet, önbellek, model seçimi, kişisel veri, onay, ziyaretçiye açık AI ve test için kısa kontrol listesi.

## Tema geliştirme

- [Tema yazma](https://fluxwp.com/wiki/tema-yazma.md): FluxWP blok teması yapısı; theme.json renkleri, şablonlar, parçalar, stil varyasyonları, koyu mod ve eklentilerle uyum.
  - [Ön ayar eklentisi](https://fluxwp.com/wiki/tema-yazma/on-ayar-eklentisi.md): Kuruma ya da siteye özel logo, renk, sayfa ve ayarları taşıyan flx-preset-* eklentileri ve preset.json.

## Sürüm ve yayın

- [Sürüm ve yayın](https://fluxwp.com/wiki/surum-ve-yayin.md): Sürüm numarası ve CHANGELOG, main'e birleşince otomatik zip ve GitHub release, güncelleme testi ve sitelere dağıtım.


---

# FluxWP nedir?

> FluxWP; WordPress için tek elden yönetilen eklenti, tema ve uygulama ailesidir. Bu sayfa repoları, paketleri ve ortak kuralları özetler.

Source: https://fluxwp.com/wiki/fluxwp-nedir/  
Section: Başlangıç  
Last updated: 2026-11-04

FluxWP; WordPress (ve WooCommerce) siteleri için tek elden geliştirilen eklenti, tema ve uygulama ailesidir. Her paket kendi işini yapar, ama ayarlar, AI, marka imzası, güncelleme ve yönetim menüsü gibi işler **ortak altyapıdan** gelir. Böylece yeni bir eklenti yazarken tekerleği yeniden icat etmezsiniz.

## Repolar

| Repo | İçerik |
|---|---|
| `FluxWP/fluxwp` | Ana monorepo: `plugins/<slug>`, `themes/<slug>`, FluxApp (React panel + Tauri) `apps/`, ortak araçlar `tools/` |
| `FluxWP/wp-extras` | Özel paketler: ön ayar eklentileri (`flx-preset-*`), TV Board, TV Remote, Staff, Qurban |
| `FluxWP/updater` | Güncelleme sunucusu (`updater.fluxwp.com`) |
| `FluxWP/whatsapp-api` | WhatsApp köprüsü |
| `FluxWP/mobile` | iOS ve Android uygulaması (Expo) |

## Ortak altyapı

- **Flux Setup** (`flx-setup`): kurulum sihirbazı, güncellemeler, ön ayarlar ve ayar şeması (`flx_settings_schema`).
- **Flux Admin** (`flx-admin`): tek yönetim menüsü, sayfa başlıkları, paket logoları, koyu tema.
- **Flux AI & MCP** (`flx-ai`): anahtarlar, modeller, harcama sınırı, ortak sohbet ve MCP sunucusu. AI kullanan her paket buradan geçer: [Eklentiyi AI destekli yapmak](https://fluxwp.com/wiki/ai-destekli-eklenti/).
- **flx-brand**: her pakete kopyalanan küçük modül; "Altyapı: FluxWP" imzası ve tarih yardımcıları `flx_date()`, `flx_time_ago()`.
- **Sistem kontrolü** (`flx_system_checks`): her paket kendi sağlık satırlarını aynı ekrana ekler.

## Temel kurallar

> [!IMPORTANT]
> Bu kurallar her pakette geçerlidir; kod incelemesinde ilk bakılan yerlerdir.

1. **Ayarlar panelden girilir.** Sunucu adresi, API anahtarı, token gibi değerler `wp-config.php` sabitine bağlanmaz; ayar ekranında durur (kurtarma sabitleri hariç, ör. `FLXRC_DISABLE`).
2. **Tüm metinler çevrilebilir.** Kaynak dil Türkçe, İngilizce çeviri pakette gelir. Koda gömülü Türkçe metin olmaz: [Çeviri ve tarih](https://fluxwp.com/wiki/eklenti-yazma/ceviri/).
3. **Tarih tek yerden.** `human_time_diff()` ve `wp_date()` doğrudan kullanılmaz; `flx_date()` ve `flx_time_ago()` kullanılır.
4. **AI tek yerden.** Paketler sağlayıcıya doğrudan istek atmaz; `flxai_chat()` kullanır.
5. **Önekler.** Her paketin kendi kod öneki vardır (`flxrc_`, `flxwk_` …): [Adlandırma kuralları](https://fluxwp.com/wiki/adlandirma/).
6. **Paylaşımlı sunucuda çalışmalı.** Hedef ortam Hostinger gibi paylaşımlı barındırma: PHP isteği ~60 saniyede kesilir, Redis ve Supervisor yoktur, WP-Cron güvenilir değildir. Uzun işler parça parça ve tarayıcı yoklamasıyla ilerler.
7. **JS paket yöneticisi Bun.** `npm` ya da `pnpm` değil.

## Nereden başlamalı?

- Yeni eklenti: [Yeni eklenti yazma](https://fluxwp.com/wiki/eklenti-yazma/)
- Eklentiye AI özelliği: [Eklentiyi AI destekli yapmak](https://fluxwp.com/wiki/ai-destekli-eklenti/)
- MCP aracı: [MCP aracı yazmak](https://fluxwp.com/wiki/ai-destekli-eklenti/mcp-araci-yazma/)
- Tema: [Tema yazma](https://fluxwp.com/wiki/tema-yazma/)
- Yayınlama: [Sürüm ve yayın](https://fluxwp.com/wiki/surum-ve-yayin/)


---

# Adlandırma kuralları

> Paket kısa adı, görünen ad, kod öneki, hook, REST ad alanı, option ve MCP araç adları için FluxWP kuralları.

Source: https://fluxwp.com/wiki/adlandirma/  
Section: Başlangıç  
Last updated: 2026-11-04

FluxWP'de birçok paket aynı sitede birlikte çalışır. Çakışma olmasın diye her adın bir kuralı vardır.

## Özet tablo

| Ne | Kural | Örnek |
|---|---|---|
| Klasör / slug | `flx-<ad>` | `flx-wiki` |
| Görünen ad | `Flux <İngilizce ad>` (her dilde aynı) | Flux Wiki |
| Tema adı | `FluxWP` | FluxWP |
| Ön ayar eklentisi | `flx-preset-<ad>` | `flx-preset-fluxwp` |
| Kod öneki | `flx<kısaltma>_` | `flxwk_search()` |
| Sınıf / sabit öneki | `FLX<KISALTMA>_` | `FLXWK_VERSION` |
| Ortak hook ve fonksiyon | `flx_` | `flx_mcp_tools`, `flx_system_checks` |
| REST ad alanı | slug + sürüm | `flx-wiki/v1` |
| Option | önek + ad | `flxwk_settings` |
| MCP aracı | önek + fiil | `flxwk_get_page` |
| npm paketi | `@fluxwp/<ad>` | `@fluxwp/panel` |

## Önek seçerken

- Önek benzersiz olmalı. Önce repoda arayın: `grep -rn "flxwk_" plugins themes`.
- Önek **eklentinin kendi hook'larında** da kullanılır (`flxwk_base`, `flxwk_ai_links`). Başka paketlerin de kullanacağı ortak hook gerekiyorsa `flx_` ile başlar ve API belgesine yazılır.
- Önek uzunluğuna bağlı kod yazmayın (ör. `substr( $key, 5 )`). Ad değişikliklerinde en çok bu tür kod kırılır.

> [!WARNING]
> MCP araç adları tüm eklentiler arasında tek bir listede durur. Öneksiz araç adı (ör. `search`) başka bir eklentinin aracıyla çakışır; her zaman önekli yazın.

## Görünen ad ve menü

Eklenti başlığındaki `Plugin Name` görünen addır (`Flux Wiki`). Yönetim menüsündeki kısa ad çevrilebilir olabilir (`Wiki`), ama paket adı çevrilmez.


---

# Bu wiki nasıl kullanılır?

> Flux Wiki'de arama, Markdown yazımı, wiki bağlantıları, not kutuları, LLM için .md ve llms.txt adresleri ve MCP araçları.

Source: https://fluxwp.com/wiki/wiki-kullanimi/  
Section: Başlangıç  
Last updated: 2026-11-04

Bu wiki **Flux Wiki** eklentisiyle çalışır. Sayfalar Markdown yazılır; her sayfa hem insanlar hem de AI ajanları için okunaklıdır.

## Arama

- Her sayfada <kbd>Ctrl</kbd> + <kbd>K</kbd> (Mac'te <kbd>⌘</kbd> + <kbd>K</kbd>) ya da <kbd>/</kbd> arama penceresini açar.
- Türkçe karakterler eşit sayılır: `ozel`, `özel` ile aynı sonucu verir.
- Sonuç en iyi eşleşen ara başlığa götürür.
- Flux AI açıksa **Wiki'ye sor** sekmesi, sorunuzu wiki sayfalarına dayanarak yanıtlar ve kaynakları listeler.

## Markdown yazımı

GitHub biçimi geçerlidir: başlıklar, listeler, tablolar, kod blokları.

```markdown
## Ara başlık

Metin, **kalın**, `satır içi kod`.

| Sütun | Açıklama |
|---|---|
| a | b |
```

Sayfa başlığını içerikte tekrar yazmayın; en üst seviye `##` olsun. İçindekiler `##` ve `###` başlıklarından üretilir.

### Wiki bağlantıları

- `[[adlandirma]]` sayfanın kısa adıyla bağlantı kurar; başlık otomatik yazılır.
- `[[eklenti-yazma/ceviri|çeviri rehberi]]` alt sayfaya, kendi etiketinizle.
- `[[adlandirma#ozet-tablo]]` sayfadaki bir başlığa.
- Olmayan sayfa kırmızı kesikli çizgiyle görünür; yazılmayı bekleyen konuları böyle işaretleyebilirsiniz.

### Not kutuları

```markdown
> [!TIP]
> Kısa ipucu.
```

Türler: `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`.

> [!TIP]
> Kod bloklarının sağ üstünde kopyalama düğmesi vardır.

## LLM ve AI ajanları için

| Adres | Ne |
|---|---|
| `/wiki/<sayfa>.md` | Sayfanın düz Markdown'u (başlık, kaynak adresi, güncelleme tarihi ile) |
| `/wiki/llms.txt` | Tüm sayfaların dizini ([llms.txt](https://llmstxt.org/) biçimi) |
| `/wiki/llms-full.txt` | Tüm wiki tek dosyada |
| `/wiki/index.md` | Dizin, Markdown |

Sayfadaki **Markdown'u kopyala** düğmesi sayfayı panoya alır; **AI'a sor** menüsü ChatGPT, Claude, Google AI ya da Perplexity'de sayfayı okutan bir sohbet başlatır. `Accept: text/markdown` başlığıyla istek atan ajanlara sayfa adresi de doğrudan Markdown döner.

## MCP

Flux AI'nin MCP sunucusu açıksa (Flux AI › MCP) şu araçlar kullanılabilir:

| Araç | Ne yapar |
|---|---|
| `flxwk_search` | Wiki'de arar |
| `flxwk_get_page` | Sayfayı Markdown olarak getirir |
| `flxwk_list_pages` | Bölümlere göre sayfa ağacı |
| `flxwk_save_page` | Sayfa yazar ya da günceller (onay ister; varsayılan taslak) |

Kaynaklar: `flxwiki://llms.txt`, `flxwiki://llms-full.txt`. İstem: `flxwk_build_plugin` (yeni eklenti işini ilgili rehberlerle başlatır).

Claude Code, Cursor gibi bir istemciye ekleyince ajan önce wiki'yi okuyup FluxWP kurallarına göre kod yazar.


---

# Yeni eklenti yazma

> Sıfırdan bir FluxWP eklentisi: klasör yapısı, ana dosya başlığı, sabitler, çeviri yükleyici, marka modülü, ikon ve paket dosyaları.

Source: https://fluxwp.com/wiki/eklenti-yazma/  
Section: Eklenti geliştirme  
Last updated: 2026-11-04

Bu rehber, `plugins/flx-ornek` adında yeni bir eklentiyi adım adım kurar. Gerçek bir örnek için repodaki `plugins/flx-recaptcha` ya da `plugins/flx-wiki` klasörüne bakın; ikisi de bu iskeleti izler.

## 1. Ad ve önek

Önce [Adlandırma kuralları](https://fluxwp.com/wiki/adlandirma/) sayfasına göre seçin:

- slug: `flx-ornek`, görünen ad: **Flux Örnek** değil **Flux Example** (görünen ad İngilizce ve her dilde aynı)
- kod öneki: `flxex_`, sınıf/sabit öneki: `FLXEX_`
- REST: `flx-ornek/v1`, option: `flxex_settings`

## 2. Klasör yapısı

```text
plugins/flx-ornek/
├── flx-ornek.php          # eklenti başlığı, sabitler, yükleyici
├── uninstall.php          # kaldırınca option/tablo temizliği
├── index.php              # "Silence is golden"
├── CHANGELOG.md           # Türkçe, en yeni sürüm üstte
├── README.md, README.tr.md
├── .distignore            # zip'e girmeyecek dosyalar
├── includes/
│   ├── helpers.php
│   ├── admin.php
│   ├── rest.php
│   ├── system-checks.php
│   └── flx-brand/         # tools/brand/sync.py kopyalar, elle değiştirmeyin
├── assets/                # css, js, icon.svg, icon-pastel.svg
├── languages/             # .pot, en_US .po/.mo/.l10n.php
├── tools/                 # genstr.py + en.json (zip'e girmez)
└── docs/logo.svg          # README için
```

Her klasöre boş `index.php` koyun.

## 3. Ana dosya

```php
<?php
/**
 * Plugin Name:       Flux Example
 * Description:       Tek cümlede ne yaptığı.
 * Version:           0.1.0
 * Requires at least: 6.4
 * Requires PHP:      7.4
 * Author:            FluxWP
 * License:           GPL-2.0-or-later
 * Text Domain:       flx-ornek
 * Domain Path:       /languages
 * Update URI:        https://updater.fluxwp.com/flx-ornek
 */

defined( 'ABSPATH' ) || exit;

require_once __DIR__ . '/includes/flx-brand/loader.php'; // FluxWP signature (tools/brand).

if ( defined( 'FLXEX_VERSION' ) ) {
	return; // aynı eklentinin iki kopyası yüklüyse
}

define( 'FLXEX_VERSION', '0.1.0' );
define( 'FLXEX_FILE', __FILE__ );
define( 'FLXEX_DIR', plugin_dir_path( __FILE__ ) );
define( 'FLXEX_URL', plugin_dir_url( __FILE__ ) );

require_once FLXEX_DIR . 'includes/helpers.php';
require_once FLXEX_DIR . 'includes/system-checks.php';
if ( is_admin() ) {
	require_once FLXEX_DIR . 'includes/admin.php';
}
```

> [!IMPORTANT]
> `Update URI` güncellemelerin FluxWP sunucusundan gelmesini sağlar; wordpress.org ile ad çakışmasını da önler. `Version` ile `FLXEX_VERSION` her zaman aynı olmalı.

## 4. Çeviri yükleyici

Kaynak metinler Türkçe yazılır, İngilizce çeviri pakette gelir. `en_GB`, `en_AU` gibi diller `en_US` çevirisine düşer:

```php
add_action( 'init', function () {
	load_plugin_textdomain( 'flx-ornek', false, dirname( plugin_basename( FLXEX_FILE ) ) . '/languages' );
}, 1 );

add_filter( 'load_textdomain_mofile', function ( $mofile, $domain ) {
	if ( 'flx-ornek' === $domain && ! is_readable( $mofile ) && preg_match( '/-en_[A-Z]{2}\.mo$/', $mofile ) ) {
		return FLXEX_DIR . 'languages/flx-ornek-en_US.mo';
	}
	return $mofile;
}, 10, 2 );
```

Ayrıntı: [Çeviri ve tarih](https://fluxwp.com/wiki/eklenti-yazma/ceviri/).

## 5. Marka imzası

```bash
python3 tools/brand/sync.py . ../wp-extras
```

Komut `includes/flx-brand/` klasörünü kopyalar ve ana dosyaya `require_once` satırını ekler. Bu modül hem "Altyapı: FluxWP" imzasını hem de `flx_date()` / `flx_time_ago()` yardımcılarını getirir. Kopyaları elle değiştirmeyin; kaynak `tools/brand/flx-brand/`.

## 6. İkon

`tools/icons/build.py` içindeki `PKGS` listesine bir satır ekleyin (slug, ad, renk grubu, [Lucide](https://lucide.dev/icons) simgesi) ve üretin:

```bash
cd tools/icons && bun install && cd ../..
python3 tools/icons/build.py
```

`assets/icon.svg`, `icon-pastel.svg`, `docs/logo.svg` ile Flux Setup ve Flux Admin'deki kopyalar yazılır. SVG'yi elle çizmeyin.

Renk grupları: `platform` (yönetim), `system` (bakım), `comms` (iletişim), `growth` (içerik ve büyüme), `commerce` (ticaret ve bağış).

## 7. Yönetim menüsü ve Flux Admin

Kendi menünüzü `add_menu_page()` ile açın; Flux Admin varsa sayfa başlığı, logo ve grup filtreleriyle tek menüye yerleşir: [Flux Admin entegrasyonu](https://fluxwp.com/wiki/eklenti-yazma/flux-admin/).

## 8. Paket dosyaları

`.distignore` (GitHub dosyaları zip'e girmesin):

```text
# GitHub tanitim dosyalari pakete girmez
./docs
./README.md
./README.tr.md
./tools
```

> [!CAUTION]
> `.distignore` yorumlarında kesme işareti (`'`) kullanmayın; `bin/build.sh` satırları `xargs` ile okur ve bozulur.

`uninstall.php` yalnız `WP_UNINSTALL_PLUGIN` tanımlıyken çalışır ve kendi option'larınızı siler.

## 9. Kontrol listesi

- [ ] Ad ve önek benzersiz
- [ ] Tüm metinler `__( '…', 'flx-ornek' )`, İngilizce karşılıkları `tools/en.json`'da
- [ ] Ayarlar panelde, şeması `flx_settings_schema`'da: [Ayarlar ve ayar şeması](https://fluxwp.com/wiki/eklenti-yazma/ayarlar/)
- [ ] Sağlık satırları `flx_system_checks`'te: [Sistem kontrolü](https://fluxwp.com/wiki/eklenti-yazma/sistem-kontrolu/)
- [ ] AI varsa yalnız Flux AI üzerinden: [Eklentiyi AI destekli yapmak](https://fluxwp.com/wiki/ai-destekli-eklenti/)
- [ ] `CHANGELOG.md` ve sürüm: [Sürüm ve yayın](https://fluxwp.com/wiki/surum-ve-yayin/)


---

# Ayarlar ve ayar şeması

> Ayarlar panelden girilir, tek option dizisinde saklanır ve flx_settings_schema ile ön ayar ve AI'ye tanıtılır.

Source: https://fluxwp.com/wiki/eklenti-yazma/ayarlar/  
Section: Eklenti geliştirme  
Last updated: 2026-11-04

FluxWP'de ayarlar **panelden** girilir. API anahtarı, sunucu adresi, token gibi değerler `wp-config.php` sabitine bağlanmaz.

## Saklama

Eklentinin ayarları tek bir option dizisinde durur: `flxex_settings`. Varsayılanlar bir fonksiyonda toplanır, okuma her zaman birleştirerek yapılır:

```php
function flxex_defaults() {
	return array( 'enabled' => 1, 'limit' => 20, 'mode' => 'auto' );
}
function flxex_settings() {
	$s = get_option( 'flxex_settings', array() );
	return array_merge( flxex_defaults(), is_array( $s ) ? $s : array() );
}
```

Gizli değerleri (API anahtarı) düz yazmayın; şifreli saklayın ve ekranda yalnız son karakterlerini gösterin.

## Kaydetme

- Form `admin-post.php`'ye gider, `check_admin_referer()` ve `current_user_can()` ile doğrulanır.
- Her alan tek tek temizlenir (`sanitize_text_field`, `absint`, izin listesi).
- Kayıttan sonra `wp_safe_redirect()` ile ayar sayfasına `?msg=saved` ile dönün.

> [!WARNING]
> Formdan gelmeyen onay kutusunu "kapalı" saymadan önce, isteğin gerçekten bu formdan geldiğini ayırın (`<option>[_form]=1` gibi gizli alan). Ön ayar ve AI ayarı kısmi dizilerle yazabilir; eksik anahtar "değişmedi" demektir.

## Ayar şeması: `flx_settings_schema`

Ön ayarlar (Flux Setup) ve AI, hangi option'da hangi alanın olduğunu bu şemadan okur. Şemada olmayan alan ön ayar önizlemesinde uyarı verir.

```php
add_filter( 'flx_settings_schema', function ( $s ) {
	$s['flxex_settings'] = array(
		'label'  => 'Flux Example',
		'fields' => array(
			'enabled' => array( 'type' => 'bool', 'default' => true, 'desc' => 'Turns the feature on.' ),
			'limit'   => array( 'type' => 'int', 'default' => 20, 'desc' => 'Max items per page.' ),
			'mode'    => array( 'type' => 'enum', 'enum' => array( 'auto', 'manual' ), 'default' => 'auto' ),
		),
	);
	return $s;
} );
```

Türler: `bool`, `int`, `string`, `text`, `html`, `enum`, `color`, `url`, `page`, `object`, `list`. `desc` İngilizce yazılır; AI okur.

Ön ayar sürümü değişince ayarlar eşitlenir ve yalnız bildirilen alanlar yazılır. Ayrıntı Flux Setup `API.md` dosyasında.


---

# Çeviri ve tarih

> Kaynak dil Türkçe, İngilizce çeviri pakette; genstr.py ile .pot/.po/.mo üretimi, JS metinleri ve flx_date / flx_time_ago.

Source: https://fluxwp.com/wiki/eklenti-yazma/ceviri/  
Section: Eklenti geliştirme  
Last updated: 2026-11-04

Her FluxWP paketi iki dille gelir: **Türkçe (kaynak)** ve **İngilizce**. Arayüzde koda gömülü metin olmaz.

## PHP'de metin

```php
esc_html_e( 'Ayarlar kaydedildi.', 'flx-ornek' );
/* translators: %d: sayfa sayısı */
printf( esc_html( _n( '%d sayfa', '%d sayfa', $n, 'flx-ornek' ) ), $n );
```

- Text domain her zaman eklentinin slug'ı.
- Yer tutuculu metinlerin üstüne `translators:` yorumu yazın.
- Metni parçalara bölüp birleştirmeyin; cümle tek parça çevrilir.

## JS'de metin

JS'ye metinler `wp_localize_script()` ile gider; JS'de Türkçe metin yazılmaz:

```php
wp_localize_script( 'flxex-admin', 'flxexAdmin', array(
	'i18n' => array( 'saved' => __( 'Kaydedildi', 'flx-ornek' ) ),
) );
```

## Çeviri dosyalarını üretmek

Her pakette `tools/genstr.py` ve `tools/en.json` bulunur. Betik PHP'deki `__()`, `esc_html__()`, `_n()` metinlerini toplar, karşılıklarını `en.json`'dan alır ve `languages/` altına `.pot`, `en_US.po`, `.mo` ve `.l10n.php` yazar.

```bash
python3 plugins/flx-ornek/tools/genstr.py
```

Eksik çeviri varsa listeler ve 1 koduyla çıkar. Yeni metin eklediyseniz `en.json`'a karşılığını yazıp tekrar çalıştırın. Yeni pakette `genstr.py`'yi başka bir paketten kopyalayıp `DOMAIN` ve proje adını değiştirin.

## Tarih ve "önce"

> [!IMPORTANT]
> `human_time_diff()`, `wp_date()` ve `date_i18n()` doğrudan kullanılmaz. Dil karışmasın diye tek yardımcı vardır.

```php
echo esc_html( flx_time_ago( $timestamp ) ); // "3 gün önce" / "3 days ago"
echo esc_html( flx_date( $timestamp ) );     // "10 Ağustos 2026" / "Aug 10, 2026"
echo esc_html( flx_date( $timestamp, 'datetime' ) );
```

İkisi de `flx-brand` modülüyle gelir; `$time` zaman damgası, MySQL tarihi ya da `DateTimeInterface` olabilir.


---

# Flux Admin entegrasyonu

> Sayfa başlığı, menü logosu, menü grubu, uygulama kısayolu ve güncelleme ekranı logosu için filtreler.

Source: https://fluxwp.com/wiki/eklenti-yazma/flux-admin/  
Section: Eklenti geliştirme  
Last updated: 2026-11-04

Flux Admin kuruluysa tüm FluxWP ekranları tek bir menüde, aynı başlık ve renklerle görünür. Eklentiniz Flux Admin'e bağımlı olmamalı; filtreler yalnız Flux Admin varken etkili olur.

## Sayfa başlığı

```php
add_filter( 'flxa_page_heads', function ( $map ) {
	$map['flx-ornek'] = 'flx-ornek'; // admin.php?page=… → paket
	return $map;
} );
add_filter( 'flxa_package_heads', function ( $heads ) {
	$heads['flx-ornek'] = array( 'Flux Example', __( 'Kısa açıklama', 'flx-ornek' ) );
	return $heads;
} );
```

## Menü logosu ve grup

```php
add_filter( 'flxa_menu_logos', function ( $m ) {
	$m['flx-ornek'] = 'flx-ornek.svg'; // flx-admin/assets/logos/ altında (build.py üretir)
	return $m;
} );
add_filter( 'flxa_default_groups', function ( $groups ) {
	if ( isset( $groups['system'][1] ) && ! in_array( 'flx-ornek', $groups['system'][1], true ) ) {
		$groups['system'][1][] = 'flx-ornek';
	}
	return $groups;
} );
```

Gruplar: `general`, `comms` (İletişim), `donate` (Bağış), `content` (İçerik), `growth` (Büyüme), `screens` (Ekranlar), `system` (Sistem). Menü öğesi bir yazı türüyse slug `edit.php?post_type=<tür>` olur.

## Güncellemeler ekranı logosu

```php
add_filter( 'flxu_package_icons', function ( $icons, $slug ) {
	if ( 'flx-ornek' === $slug && ! $icons ) {
		$url   = FLXEX_URL . 'assets/icon.svg?ver=' . FLXEX_VERSION;
		$icons = array( 'svg' => $url, '1x' => $url, '2x' => $url );
	}
	return $icons;
}, 10, 2 );
```

## Uygulama kısayolu

FluxApp ve Flux Admin hızlı erişim listesine ekran eklemek için `flxa_apps`:

```php
add_filter( 'flxa_apps', function ( $apps ) {
	$apps['ornek'] = array(
		'label' => __( 'Örnek', 'flx-ornek' ),
		'url'   => admin_url( 'admin.php?page=flx-ornek' ),
		'cap'   => 'manage_options',
		'icon'  => 'sparkles',
	);
	return $apps;
} );
```


---

# Sistem kontrolü

> Her paket kendi sağlık satırlarını flx_system_checks ile ortak Sistem kontrolü ekranına ekler.

Source: https://fluxwp.com/wiki/eklenti-yazma/sistem-kontrolu/  
Section: Eklenti geliştirme  
Last updated: 2026-11-04

FluxWP paketleri ve tema, sağlık durumlarını tek bir **Sistem kontrolü** ekranında gösterir. Hata varsa üst çubukta "Sistem: N hata" görünür.

```php
add_filter( 'flx_system_checks', function ( $checks ) {
	$checks[] = array(
		'id'           => 'flxex.key',            // <önek>.<konu>
		'source'       => 'Flux Example',
		'group'        => 'Config',               // Cron, Payments, Plugins, Config, Email, Security, Forms …
		'label'        => __( 'API anahtarı', 'flx-ornek' ),
		'status'       => flxex_has_key() ? 'ok' : 'warning', // ok | warning | error | info
		'message'      => flxex_has_key() ? __( 'Anahtar girilmiş.', 'flx-ornek' ) : __( 'Anahtar yok; özellik kapalı.', 'flx-ornek' ),
		'action_url'   => admin_url( 'admin.php?page=flx-ornek' ),
		'action_label' => __( 'Ayarlar', 'flx-ornek' ),
	);
	return $checks;
} );

add_filter( 'flx_system_checks_versions', function ( $v ) {
	$v['flx-ornek'] = FLXEX_VERSION; // sürüm değişince gizlenen uyarılar yeniden görünür
	return $v;
} );
```

## Kurallar

- Kontroller **ucuz** olmalı: option, sabit, birkaç sorgu. Her sayfa açılışında dış HTTP isteği yok.
- Dış servis testi yalnız yönetici "Test" bağlantısına tıklayınca çalışır; sonuç saklanıp satırda gösterilir.
- Gizli anahtar hiçbir satırda yazılmaz.
- Mesaj kişiye yöneliktir: ne bulundu ve ne yapmalı.


---

# Eklentiyi AI destekli yapmak

> AI kullanan her FluxWP eklentisi Flux AI üzerinden geçer; flxai_chat, flxai_ready, kaynak kaydı, hatalar ve yedek kod.

Source: https://fluxwp.com/wiki/ai-destekli-eklenti/  
Section: AI ve MCP  
Last updated: 2026-11-04

Eklentinize AI özelliği (özet, öneri, sınıflandırma, sohbet aracı) eklerken sağlayıcıya **doğrudan istek atmayın**. Tüm AI çağrıları **Flux AI & MCP** (`flx-ai`) üzerinden geçer. Böylece:

- API anahtarları, model seçimi ve önbellek tek yerde,
- günlük / haftalık / aylık harcama sınırı tüm paketlerde geçerli,
- her istek **Kayıtlar** ve **Raporlar** ekranına eklenti ve amaç bazında düşer,
- yönetici bir eklentinin AI'sini **Bağlı sistemler**'den tek tıkla kapatabilir.

## 1. Kendini tanıt

```php
add_filter( 'flxai_systems', function ( $s ) {
	$s['flx-ornek'] = array(
		'label'  => 'Flux Example',
		'plugin' => plugin_basename( FLXEX_FILE ),
		'page'   => 'admin.php?page=flx-ornek',
	);
	return $s;
} );
add_filter( 'flxai_sources', function ( $s ) {
	$s['flx-ornek'] = 'Flux Example';
	return $s;
} );
add_filter( 'flxai_purpose_labels', function ( $l ) {
	$l['summary'] = __( 'Özet', 'flx-ornek' );
	return $l;
} );
```

## 2. Hazır mı?

```php
function flxex_ai_ready() {
	return function_exists( 'flxai_chat' )
		&& flxai_ready( 'flx-ornek' )                 // anahtar var mı
		&& flxai_source_enabled( 'flx-ornek' );       // Bağlı sistemler'de açık mı
}
```

Hazır değilse AI düğmesini gizleyin ya da "Flux AI'yi kurun" bağlantısı gösterin. Flux AI kurulu değilken eklenti **hata vermeden** çalışmaya devam etmeli.

## 3. İstek

```php
$res = flxai_chat(
	array(
		array( 'role' => 'system', 'content' => 'You summarize orders in one sentence.' ),
		array( 'role' => 'user', 'content' => $text ),
	),
	array(
		'source'     => 'flx-ornek',   // zorunlu: raporlar ve eklentiye özel model
		'purpose'    => 'summary',     // raporda "Amaca göre"
		'max_tokens' => 400,
		'timeout'    => 40,            // paylaşımlı sunucu ~60 sn'de keser
	)
);
if ( is_wp_error( $res ) ) {
	if ( flxai_is_account_error( $res ) ) {
		// harcama sınırı, anahtar, kapalı sistem: toplu işi durdurun
	}
	return $res;
}
$summary = trim( $res['content'] );
```

Mesajlar OpenAI biçimindedir; Claude'a otomatik çevrilir. Tek metin için kısa yol: `flxai_complete( $prompt, array( 'source' => 'flx-ornek', 'system' => '…' ) )`.

Dönen değerde `content`, varsa `tool_calls`, `_finish` (`stop`, `tool_calls`, `length`) ve `_usage` (model, token, maliyet) bulunur.

## 4. Sistem talimatını önbelleğe uygun yazın

Sistem içeriği parça dizisi olabilir. Sabit talimatı başa koyup `cache => true` işaretleyin, değişen bilgiyi sonra ekleyin:

```php
'content' => array(
	array( 'type' => 'text', 'text' => FLXEX_RULES, 'cache' => true ), // sabit
	array( 'type' => 'text', 'text' => 'Order: ' . $json ),             // değişken
),
```

## 5. Hatalar

| Kod | Anlam |
|---|---|
| `flxai_limit` | Harcama sınırı doldu (402) |
| `flxai_key` | Anahtar yok |
| `flxai_source_off` | Yönetici bu eklentinin AI'sini kapattı |
| `flxai_http` | Ağ hatası |
| `flxai_api` | Sağlayıcı hatası (`data.http`, `data.msg`) |
| `flxai_empty` | Boş cevap |

> [!TIP]
> Kullanıcıya sağlayıcı hata metnini olduğu gibi göstermeyin; kısa, çevrilmiş bir mesaj ve "tekrar dene" yeterli. Ayrıntı Flux AI › Kayıtlar'da zaten var.

## 6. Ayar ekranı

- Kendi anahtar alanınızı açmayın; "Anahtarlar Flux AI'den gelir" notu yeterli.
- Eklentiye özel model seçtirmek isterseniz: okuma `flxai_model_for( 'flx-ornek' )`, yazma `flxai_set_source_model( 'flx-ornek', $model )`, liste için `flxai_enqueue_model_picker()` ve alana `data-flxai-model`.

## 7. Uzun işler

Paylaşımlı sunucuda PHP isteği ~60 saniyede kesilir. Toplu AI işlerini (100 ürün açıklaması gibi) **parça parça** yapın: tarayıcı bir REST ucunu yoklar, her çağrıda birkaç öğe işlenir, durum option ya da tabloda tutulur. `flxai_is_account_error()` `true` dönerse kuyruğu durdurun.

## Sonraki adım

- Özelliğinizi Flux AI sohbetine ve dış ajanlara açmak: [MCP aracı yazmak](https://fluxwp.com/wiki/ai-destekli-eklenti/mcp-araci-yazma/)
- Maliyet, gizlilik ve test: [AI için iyi uygulamalar](https://fluxwp.com/wiki/ai-destekli-eklenti/iyi-uygulamalar/)


---

# MCP aracı yazmak

> flx_mcp_tools ile eklentinizin işlevlerini Flux AI sohbetine ve dış MCP istemcilerine (Claude, Cursor) açın; kaynak ve istem ekleyin.

Source: https://fluxwp.com/wiki/ai-destekli-eklenti/mcp-araci-yazma/  
Section: AI ve MCP  
Last updated: 2026-11-04

Flux AI ortak bir **MCP sunucusu** çalıştırır: `/wp-json/flx-mcp/v1/mcp` (Streamable HTTP, JSON-RPC 2.0). Kaydettiğiniz araç hem dış MCP istemcilerinde (Claude, Cursor, Claude Code) hem de Flux AI'nin yönetim sohbetinde görünür.

## Araç kaydı

```php
add_filter( 'flx_mcp_tools', function ( $tools ) {
	$tools['flxex_list_items'] = array(
		'title'       => __( 'Öğeleri listele', 'flx-ornek' ), // arayüzde görünen ad
		'description' => 'Lists items with status and date. Use q to filter by title.', // modele gider, İngilizce
		'readonly'    => true,                 // false: değiştirir → sohbette onay kartı
		'cap'         => 'edit_posts',         // yetkisi olmayan kullanıcı aracı görmez
		'source'      => 'flx-ornek',
		'schema'      => array(
			'type'       => 'object',
			'properties' => array(
				'q'     => array( 'type' => 'string', 'description' => 'Search in titles.' ),
				'limit' => array( 'type' => 'integer', 'description' => 'Max 50.' ),
			),
		),
		'run'         => function ( $args ) {
			$items = flxex_find_items( (string) ( $args['q'] ?? '' ), min( 50, (int) ( $args['limit'] ?? 20 ) ) );
			return array( 'items' => $items ); // dizi → structuredContent
		},
	);
	return $tools;
} );
```

## Kurallar

1. **Önekli ad.** `flxex_list_items`, `list_items` değil. Ad `^[a-zA-Z0-9_-]{1,64}$`.
2. **İngilizce açıklama.** Model okur: ne yapar, ne döner, hangi durumda kullanılır. Kısa ve kesin.
3. **Yetki.** `cap` verin; `run` içinde nesne düzeyinde de kontrol edin (`current_user_can( 'edit_post', $id )`). Araç, MCP anahtarını oluşturan kullanıcının yetkisiyle çalışır.
4. **Değiştiren araçlar `readonly => false`.** Flux AI sohbetinde çalışmadan önce kullanıcıdan onay alınır. Silme gibi geri alınamayan işlemleri ayrı araç yapın ya da taslak / çöp kutusuna yönlendirin.
5. **Hata için Exception.** `throw new Exception( 'Item not found.' );` MCP'de `isError` olarak döner.
6. **Küçük çıktı.** Sonuç 30.000 karakterde kesilir. Liste araçlarında `limit` ve kısa alanlar döndürün; ayrıntı için ayrı "get" aracı yazın.
7. **Yoklama araçları** `log => false` ile Son işlemler'i doldurmaz.

> [!NOTE]
> Eski filtre `flxseo_mcp_tools` hâlâ çalışır, ama yeni kodda `flx_mcp_tools` kullanın.

## Yalnız sohbette görünen araç

Dış MCP'ye açılmaması gereken (ör. o anki ekrana bağlı) bir araç için `flxai_tools` filtresini kullanın. Biçim aynı; `run` ikinci parametre olarak `$ctx` (`user_id`, `chat_id`, `source`) alır.

## Kaynaklar ve istemler

```php
add_filter( 'flx_mcp_resources', function ( $res ) {
	$res['flxex://catalog'] = array(
		'name'        => 'catalog',
		'title'       => 'Item catalog',
		'description' => 'All items as Markdown.',
		'mimeType'    => 'text/markdown',
		'read'        => 'flxex_catalog_markdown', // string döndürür
		'cap'         => 'read',
	);
	return $res;
} );

add_filter( 'flx_mcp_prompts', function ( $p ) {
	$p['flxex_review'] = array(
		'title'       => 'Review items',
		'description' => 'Starts a review of open items.',
		'arguments'   => array( array( 'name' => 'status', 'required' => false ) ),
		'text'        => function ( $a ) { return 'Review the open items …'; },
	);
	return $p;
} );

add_filter( 'flx_mcp_instructions', function ( $lines ) {
	$lines[] = 'Items: use flxex_list_items before editing anything.';
	return $lines;
} );
```

## Test

1. Flux AI › MCP'de sunucuyu açın ve bir anahtar oluşturun.
2. Claude Code'a ekleyin:

```bash
claude mcp add --transport http fluxwp https://site.com/wp-json/flx-mcp/v1/mcp \
  --header "Authorization: Bearer <anahtar>"
```

3. Ya da yönetim panelindeki Flux AI sohbetinde aracı adıyla isteyin. Her çağrı Flux AI › MCP › Son işlemler'de görünür.

Örnek: bu wiki'nin araçları `flxwk_search`, `flxwk_get_page`, `flxwk_list_pages`, `flxwk_save_page` (`plugins/flx-wiki/includes/mcp.php`).


---

# AI için iyi uygulamalar

> Maliyet, önbellek, model seçimi, kişisel veri, onay, ziyaretçiye açık AI ve test için kısa kontrol listesi.

Source: https://fluxwp.com/wiki/ai-destekli-eklenti/iyi-uygulamalar/  
Section: AI ve MCP  
Last updated: 2026-11-04

## Maliyet

- Varsayılan model ucuz ve hızlı olsun; pahalı modeli yalnız gerekli amaçlarda (`purpose`) seçin.
- `max_tokens` değerini işe göre verin; kısa özet için 300–500 yeter.
- Sabit sistem talimatını `cache => true` parçasına koyun.
- Aynı girdi için cevabı kendi tarafınızda saklayın (ör. ürün açıklaması bir kez üretilir).

## Ziyaretçiye açık AI

Herkese açık bir AI özelliği (ör. bu wiki'deki **Wiki'ye sor**) bütçeyi hızla tüketebilir:

- Varsayılanı "giriş yapmış kullanıcılar" yapın.
- Kişi ya da IP başına saatlik sınır koyun.
- Bağlamı kısıtlayın: model yalnız sizin verdiğiniz içerikten cevap versin, kaynakları listelesin.
- Uzunluk sınırı koyun (soru 1.000 karakter gibi).

## Kişisel veri

- Modele yalnız gereken alanları gönderin. Telefon, e-posta, IBAN gibi bilgiler gerekmiyorsa çıkarın.
- Flux AI kayıtları e-posta, 10+ haneli sayı, IBAN ve anahtarları maskeler. Kendi alanınız için `flxai_log_mask` filtresine kural ekleyin.

## Onay

Veri değiştiren her AI işlemi kullanıcı onayından geçmeli. Flux AI sohbetinde `readonly => false` araçlar zaten onay ister. Kendi ekranınızda da önizleme gösterip "Uygula" ile yazın.

## Cevabı gösterme

- Model Markdown döner; ekranda gösterirken temizleyin (`wp_kses_post`).
- Sohbet gibi uzun cevaplarda akış kullanın: `flxai_chat( $messages, array( 'stream' => function ( $ev ) { … } ) )`.
- Grafik ya da tablo için ```widget ve ```mermaid blokları: `flxai_widget_rules()`.

## Test

- Flux AI yokken eklenti açılıyor mu, AI düğmeleri gizli mi?
- Anahtar yanlışken kullanıcı anlamlı mesaj görüyor mu?
- Harcama sınırı dolunca toplu iş duruyor mu?
- Bağlı sistemler'den kapatınca özellik gerçekten kapanıyor mu?


---

# Tema yazma

> FluxWP blok teması yapısı; theme.json renkleri, şablonlar, parçalar, stil varyasyonları, koyu mod ve eklentilerle uyum.

Source: https://fluxwp.com/wiki/tema-yazma/  
Section: Tema geliştirme  
Last updated: 2026-11-04

FluxWP temaları **blok temasıdır** (Site Editor uyumlu). Referans tema `themes/fluxwp`. Yeni bir tema yazmadan önce, ihtiyacın bir **ön ayar eklentisiyle** karşılanıp karşılanmadığına bakın: [Ön ayar eklentisi](https://fluxwp.com/wiki/tema-yazma/on-ayar-eklentisi/). Kurumlara özel her şey (logo, renk, içerik, sayfalar) ön ayardadır; tema geneldir.

## Yapı

```text
themes/fluxwp/
├── style.css          # tema başlığı (Theme Name, Version, Update URI, Text Domain)
├── theme.json         # renk, yazı, boşluk ön ayarları, düzen genişlikleri
├── functions.php      # theme support, varlıklar, inc/ yükleyici
├── templates/         # index, single, page, archive, search, 404 … (.html)
├── parts/             # header.html, footer.html
├── patterns/          # hero.php, ozellikler.php … (çevrilebilir metinlerle)
├── styles/            # stil varyasyonları: antrasit, indigo, mavi, orman, petrol
├── inc/               # ayarlar, dil, hız, erişilebilirlik, WooCommerce
├── preset/            # temanın kendi ön ayarı (preset.json)
└── assets/            # css, js, görseller
```

## Renkler: eklentiler tema rengini izler

Eklentiler kendi renklerini sabit yazmaz; tema ön ayar değişkenlerini kullanır. Böylece stil varyasyonu ya da koyu mod değişince eklenti ekranları da değişir.

| Değişken | Kullanım |
|---|---|
| `--wp--preset--color--primary` | ana renk (düğme, vurgu) |
| `--wp--preset--color--leaf` | ikinci vurgu, bağlantı |
| `--wp--preset--color--ink` | başlık |
| `--wp--preset--color--text` | metin |
| `--wp--preset--color--line` | çizgi, kenarlık |
| `--wp--preset--color--mint`, `--mint-soft` | açık zemin |
| `--flx-surface` | kart zemini (koyu modda koyu) |

Eklenti CSS'inde her zaman yedek değer verin; tema FluxWP değilse de düzgün görünsün:

```css
.flxex-card{
  border:1px solid var(--wp--preset--color--line,#E5E7EB);
  color:var(--wp--preset--color--text,#374151);
  background:var(--flx-surface,#fff);
}
```

## Koyu mod

FluxWP teması koyu modu `body.flx-dark` sınıfı ve `prefers-color-scheme: dark` ile açar; yukarıdaki değişkenleri koyu karşılıklarıyla değiştirir. Değişkenleri kullanan eklenti ek iş yapmadan koyu moda uyar. Sabit `#fff` zeminlerden kaçının.

## Temanın desteklediği özellikler

```php
add_theme_support( 'flx-theme' );   // FluxWP uyumlu tema
add_theme_support( 'flx-credit' );  // altlıkta "Altyapı: FluxWP" imzası (blok kaldırılırsa yedek çubuk)
add_theme_support( 'flx-setup-panel', array( 'page' => 'flx-ayarlar', 'arg' => 'bolum', 'value' => 'onayarlar' ) );
```

## Eklentinin tema içinde sayfa göstermesi

Bir eklenti kendi ön yüz sayfasını (bu wiki gibi) gösterecekse temanın başlık ve altlığını korumalı:

- **Blok temada**: tema başlık/altlık parçaları ile kendi dinamik bloğunuzu birleştiren bir şablon içeriği kurun ve `template-canvas.php` döndürün. Örnek: `plugins/flx-wiki/includes/front.php`.
- **Klasik temada**: `get_header()`, içerik, `get_footer()`.

## Metinler

Şablon (`.html`) dosyalarındaki metinler çevrilemez. Çevrilmesi gereken metinleri **pattern** (`patterns/*.php`) içinde `esc_html_e()` ile yazın ve şablonda pattern'i çağırın.


---

# Ön ayar eklentisi

> Kuruma ya da siteye özel logo, renk, sayfa ve ayarları taşıyan flx-preset-* eklentileri ve preset.json.

Source: https://fluxwp.com/wiki/tema-yazma/on-ayar-eklentisi/  
Section: Tema geliştirme  
Last updated: 2026-11-04

Bir siteye ya da kuruma özel olan her şey (logo, renk paleti, sayfalar, menüler, eklenti ayarları) **ön ayar eklentisinde** durur. Tema ve eklentiler genel kalır.

## Yapı

```text
wp-extras/plugins/flx-preset-ornek/
├── flx-preset-ornek.php
├── preset/
│   ├── preset.json      # flx-preset/1 şeması
│   └── assets/          # logo, görseller
├── patterns/            # siteye özel pattern'ler
└── inc/
```

Flux Setup `flx-preset-*` eklentilerini kendiliğinden bulur ve **Tema Ayarları › Ön ayarlar** ekranında listeler.

## preset.json

Şema: `plugins/flx-setup/schema/flx-preset.schema.json`. Belgeler: `docs/flx-setup/FORMAT.md` ve `plugins/flx-setup/API.md`.

Başlıca bölümler: `profile` (site adı, logo, renk), `wp` (WordPress ayarları), `settings` (eklenti option'ları; alanlar `flx_settings_schema`'dan), içerik (sayfa, menü, ürün) ve `migrations`.

## Sürüm ve eşitleme

- `version` artınca ayarlar eşitlenir; **yalnız ön ayarın bildirdiği alanlar** yazılır, sitede elle değiştirilen değerlere dokunulmaz.
- Sonradan eklenen içerik `migrations` ile gelir (`id` bir kez yayınlandıktan sonra değişmez).
- Her uygulama geri alınabilir bir kayıttır.

> [!TIP]
> Eklentiniz ön ayarla ayarlanabilsin istiyorsanız alanlarını `flx_settings_schema` ile tanımlayın: [Ayarlar ve ayar şeması](https://fluxwp.com/wiki/eklenti-yazma/ayarlar/).


---

# Sürüm ve yayın

> Sürüm numarası ve CHANGELOG, main'e birleşince otomatik zip ve GitHub release, güncelleme testi ve sitelere dağıtım.

Source: https://fluxwp.com/wiki/surum-ve-yayin/  
Section: Sürüm ve yayın  
Last updated: 2026-11-04

FluxWP paketleri elle zip'lenip yüklenmez. Sürüm numarasını artırıp `main`'e birleştirmek yeterlidir.

## Akış

1. Değişikliği bir dalda yapın, PR açın.
2. Ana dosyadaki `Version:` başlığını ve sürüm sabitini (`FLXEX_VERSION`) birlikte artırın.
3. `CHANGELOG.md`'nin en üstüne yeni sürümü yazın (Türkçe, kullanıcının anlayacağı dille).
4. PR birleşince **Paket release** iş akışı (`.github/workflows/release.yml`) çalışır:
   - sürümü değişen her paket için `bin/build.sh` ile zip üretir (`.distignore` dışındakiler),
   - temiz bir WordPress'e önceki sürümü kurup yeni sürüme geçer, sayfaları açar (`bin/test-update.sh`); PHP fatal ya da HTTP 500 olursa yayınlamaz,
   - `<slug>-v<sürüm>` etiketi ve GitHub Release oluşturur,
   - güncelleme sunucusunun önbelleğini boşaltır.
5. Siteler güncellemeyi **Flux Setup** üzerinden `updater.fluxwp.com`'dan alır.

## Sürüm numarası

- `0.x` ilk geliştirme; `1.0.0` kararlı.
- Hata düzeltme: yama (`1.4.1`), yeni özellik: küçük (`1.5.0`), uyumu bozan değişiklik: büyük (`2.0.0`).
- Sürümde `-` varsa (`1.2.0-beta.1`) ön sürüm (pre-release) olur.
- Aynı numara iki kez yayınlanmaz; bir sürüm alındıysa bir sonrakini kullanın.

## Yerelde zip

```bash
bin/build.sh plugins/flx-ornek   # dist/flx-ornek.zip
```

## Commit ve PR

- Commit mesajları İngilizce ve kısa (`Add wiki search`, `Fix certificate preview`).
- Her PR tek pakete odaklansın; ortak bir filtre gerekiyorsa sahibi pakete ayrı PR açın ve API belgesine yazın.

## Güncelleme sunucusu

`Update URI: https://updater.fluxwp.com/<slug>` başlığı paketi FluxWP sunucusuna bağlar. Herkese açık depolar anahtarsız dağıtılır; özel depolar yalnız anahtara tanımlı paketlere açılır.