Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/burakcaylak/ofis-rehberi/archive/refs/heads/master.zipWordPress siteniz için ofis rehberi tablosunu yönetmenizi ve görüntülemenizi sağlar. Excel içe/dışa aktarma, arama, sıralama ve embed desteği içerir.
Özellikler
- Tablo yönetimi: Admin panelinde satır/sütun ekleme, silme, sürükle-bırak ile sıralama
- Excel: XLSX/XLS içe aktarma ve dışa aktarma (PhpSpreadsheet)
- Shortcode: Sayfa veya yazıda
[ofis_rehberi]ile tablo ve arama kutusu - Embed: Harici sayfalara gömülebilir tam sayfa rehber URL’i
- DataTables: Frontend’de arama, sıralama, sabit başlık (fixed header)
- Mobil: Responsive tablo ve mobil kart görünümü
- Veri: Tablo verisi WordPress
option(JSON) olarak saklanır
Gereksinimler
- WordPress 5.0+
- PHP 7.4+
- Composer (PhpSpreadsheet kurulumu için)
Kurulum
- Depoyu klonlayın veya indirin:
git clone https://github.com/burakcaylak/ofis-rehberi.git - Eklenti klasörüne girin ve bağımlılıkları kurun:
cd ofis-rehberi composer install ofis-rehberiklasörünüwp-content/plugins/içine kopyalayın (veya klonladığınız yeri oraya taşıyın).- Yönetim panelinde Eklentiler → Ofis Rehberi → Etkinleştir.
Not:
composer installçalıştırılmazsa admin panelinde "PhpSpreadsheet kütüphanesi bulunamadı" uyarısı çıkar; Excel içe/dışa aktarma çalışmaz.
Kullanım
Shortcode
Rehber tablosunu bir sayfaya eklemek için:
[ofis_rehberi]
Tablo, arama kutusu ile birlikte gösterilir; DataTables ile sıralama ve arama yapılır.
Embed URL
Harici sayfalara (iframe vb.) gömülebilir tam sayfa rehber:
https://siteniz.com/?ofis_rehberi_embed=1
Admin panelinde Ofis Rehberi sayfasında bu URL kopyalanabilir.
Yönetim paneli
WordPress Admin → Ofis Rehberi:
- Tabloyu düzenleyin: ilk satır başlık, diğer satırlar veri
- Satır Ekle / Sütun Ekle ile yapıyı genişletin
- Sürükle-bırak ile satır ve sütun sırasını değiştirin
- Tabloyu Kaydet ile veriyi kaydedin
- Excel'e Aktar ile XLSX indirin
- Excel'den Aktar ile XLSX/XLS yükleyip mevcut tabloyu güncelleyin
Dosya yapısı
ofis-rehberi/
├── assets/
│ ├── jquery.dataTables.min.js
│ ├── jquery.dataTables.min.css
│ ├── dataTables.fixedHeader.min.js
│ ├── fixedHeader.dataTables.min.css
│ ├── style.css
│ └── index.php
├── vendor/ # composer install ile oluşur (PhpSpreadsheet)
├── composer.json
├── composer.lock
├── ofis-rehberi.php # Ana eklenti dosyası
├── index.php
└── README.md
Bağımlılıklar
- phpoffice/phpspreadsheet (^1.29): Excel okuma/yazma.
composer installile kurulur. - jQuery ve DataTables: Frontend’de tablo arama/sıralama; eklenti
assetsiçinde taşınır.
Veri saklama
Tablo verisi get_option('ofis_rehberi_data') ile JSON string olarak saklanır. İlk satır başlık, sonraki satırlar veri satırlarıdır. Varsayılan örnek: Ofis Adı, Kat Numarası, Telefon.
Lisans
GPL v2 veya üzeri. Detay için WordPress License sayfasına bakın.
Katkıda bulunma
- Bu depoyu fork edin.
- Yeni bir dal oluşturun:
git checkout -b feature/yeni-ozellik - Değişikliklerinizi commit edin:
git commit -m 'Yeni özellik eklendi' - Dalı push edin:
git push origin feature/yeni-ozellik - Bir Pull Request açın.
İletişim
Yazar: Ahmet Burak Çaylak
Depo: github.com/burakcaylak/ofis-rehberi