XMF Çerçeve

2.5.x ✅ 4.0.x ✅

Modern’e Köprü XOOPS

XMF hem XOOPS 2.5.x hem de XOOPS 4.0.x ile çalışır. XOOPS 4.0’a hazırlanırken modüllerinizi bugün modernleştirmenin önerilen yoludur. XMF, PSR-4 otomatik yükleme, ad alanları ve geçişi kolaylaştıran yardımcılar sağlar.

XOOPS module Çerçevesi (XMF), XOOPS module geliştirmeyi basitleştirmek ve standartlaştırmak için tasarlanmış güçlü bir kitaplıktır. XMF, ad alanları, otomatik yükleme ve standart kodu azaltan ve sürdürülebilirliği artıran kapsamlı bir dizi yardımcı sınıf dahil olmak üzere modern PHP uygulamaları sağlar.

XMF nedir?

XMF aşağıdakileri sağlayan sınıflar ve yardımcı programlardan oluşan bir koleksiyondur:

• Modern PHP Desteği - PSR-4 otomatik yüklemeyle tam ad alanı desteği
• İstek İşleme - Güvenli giriş doğrulama ve temizleme
• module Yardımcıları - module yapılandırmalarına ve nesnelerine basitleştirilmiş erişim
• İzin Sistemi - Kullanımı kolay izin yönetimi
• database Yardımcı Programları - Şema taşıma ve tablo yönetimi araçları
• JWT Destek - JSON Güvenli kimlik doğrulama için Web Token uygulaması
• Meta Veri Oluşturma - SEO ve içerik çıkarma yardımcı programları
• Yönetici Arayüzü - Standartlaştırılmış module yönetim sayfaları

XMF Bileşenlere Genel Bakış

graph TB
    subgraph XMF["XMF Framework"]
        direction TB
        subgraph Core["Core Components"]
            Request["🔒 Request<br/>Input Handling"]
            Module["📦 Module Helper<br/>Config & Handlers"]
            Perm["🔑 Permission<br/>Access Control"]
        end

        subgraph Utils["Utilities"]
            DB["🗄️ Database<br/>Schema Tools"]
            JWT["🎫 JWT<br/>Token Auth"]
            Meta["📊 Metagen<br/>SEO Utils"]
        end

        subgraph Admin["Admin Tools"]
            AdminUI["🎨 Admin UI<br/>Standardized Pages"]
            Icons["🖼️ Icons<br/>Font Awesome"]
        end
    end

    subgraph Module["Your Module"]
        Controller["Controller"]
        Handler["Handler"]
        Template["Template"]
    end

    Controller --> Request
    Controller --> Module
    Controller --> Perm
    Handler --> DB
    Template --> AdminUI

    style XMF fill:#e3f2fd,stroke:#1976d2
    style Core fill:#e8f5e9,stroke:#388e3c
    style Utils fill:#fff3e0,stroke:#f57c00
    style Admin fill:#fce4ec,stroke:#c2185b

Temel Özellikler

Ad Alanları ve Otomatik Yükleme

Tüm XMF sınıfları Xmf ad alanında bulunur. Sınıflar referans alındığında otomatik olarak yüklenir; herhangi bir kılavuza gerek yoktur.

use Xmf\Request;
use Xmf\Module\Helper;

// Classes load automatically when used
$input = Request::getString('input', '');
$helper = Helper::getHelper('mymodule');

Güvenli İstek İşleme

Request sınıfı, yerleşik temizleme özelliğiyle HTTP istek verilerine tür açısından güvenli erişim sağlar:

flowchart LR
    subgraph Input["Raw Input"]
        GET["$_GET"]
        POST["$_POST"]
        REQUEST["$_REQUEST"]
    end

    subgraph XMF["Xmf\\Request"]
        Validate["Type Validation"]
        Sanitize["Sanitization"]
        Default["Default Values"]
    end

    subgraph Output["Safe Output"]
        Int["getInt()"]
        Str["getString()"]
        Email["getEmail()"]
        Bool["getBool()"]
    end

    GET --> XMF
    POST --> XMF
    REQUEST --> XMF
    XMF --> Int
    XMF --> Str
    XMF --> Email
    XMF --> Bool

    style Input fill:#ffcdd2,stroke:#c62828
    style XMF fill:#fff3e0,stroke:#f57c00
    style Output fill:#c8e6c9,stroke:#2e7d32

use Xmf\Request;

$id = Request::getInt('id', 0);
$name = Request::getString('name', '');
$email = Request::getEmail('email', '');

module Yardımcı Sistemi

module Yardımcısı modülle ilgili işlevlere kolay erişim sağlar:

$helper = \Xmf\Module\Helper::getHelper('mymodule');

// Access module configuration
$configValue = $helper->getConfig('setting_name', 'default');

// Get module object
$module = $helper->getModule();

// Access handlers
$handler = $helper->getHandler('items');

İzin Yönetimi

İzin Yardımcısı, XOOPS izin işlemeyi basitleştirir:

$permHelper = new \Xmf\Module\Helper\Permission();

// Check user permission
if ($permHelper->checkPermission('view', $itemId)) {
    // User has permission
}

Dokümantasyon Yapısı

Temel Bilgiler

• Başlarken-XMF - Kurulum ve temel kullanım
• XMF-Request - İstek işleme ve giriş doğrulama
• XMF-Module-Helper - module yardımcı sınıfı kullanımı

Tarifler

• Permission-Helper - İzinlerle çalışma
• module-Yönetici-Sayfaları - Standartlaştırılmış yönetici arayüzleri oluşturma

Referans

• JWT - JSON Web Token uygulaması
• database - database yardımcı programları ve şema yönetimi
• Metagen - Meta veriler ve SEO yardımcı programları

Gereksinimler

• XOOPS 2.5.8 veya üzeri
• PHP 7.2 veya üstü (PHP 8.x önerilir)

Kurulum

XMF, XOOPS 2.5.8 ve sonraki sürümlere dahildir. Daha önceki sürümler veya manuel kurulum için:

1. XMF paketini XOOPS deposundan indirin
2. XOOPS /class/xmf/ dizininize çıkartın
3. Otomatik yükleyici sınıf yüklemesini otomatik olarak gerçekleştirecektir

Hızlı Başlangıç Örneği

Yaygın XMF kullanım kalıplarını gösteren tam bir örnek:

<?php
use Xmf\Request;
use Xmf\Module\Helper;
use Xmf\Module\Helper\Permission;

// Get module helper
$helper = Helper::getHelper('mymodule');

// Get configuration values
$itemsPerPage = $helper->getConfig('items_per_page', 10);

// Handle request input
$op = Request::getCmd('op', 'list');
$id = Request::getInt('id', 0);

// Check permissions
$permHelper = new Permission();
if (!$permHelper->checkPermission('view', $id)) {
    redirect_header('index.php', 3, 'Access denied');
}

// Process based on operation
switch ($op) {
    case 'view':
        $handler = $helper->getHandler('items');
        $item = $handler->get($id);
        // ... display item
        break;
    case 'list':
    default:
        // ... list items
        break;
}

Kaynaklar

• XMF GitHub Deposu
• XOOPS Proje Web Sitesi

---

#xmf #xoops #framework #php #module geliştirme