WP Manifestindependent plugin directory
manifest / users / kisi-rehberi

Kişi Rehberi

WordPress siteniz için kişi/dahili numaralar rehberi.

by Ahmet Burak ÇAYLAK · github.com/burakcaylak/kisi-rehberi

★ 0stars

Install

Download source zip No release zip yet

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/kisi-rehberi/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/burakcaylak/kisi-rehberi ↗

WordPress siteniz için kişi ve dahili numaralar rehberi. Kullanıcı listesini tablo veya kart görünümünde sunar, arama, favoriler ve Excel dışa/içe aktarma destekler.

Özellikler

  • Kişi listesi: WordPress kullanıcıları + özel kişiler (dahili, e-posta, departman, bölüm, unvan, görev, lokasyon)
  • BuddyPress uyumu: XProfile alanlarından veri okuma/yazma (Dahili, Departman, Bölüm, Lokasyon, Unvan, Görevi)
  • Özel kişiler: Sitede hesabı olmayan kişileri manuel ekleme ve yönetme
  • Gizli kullanıcılar: Rehberde görünmesini istemediğiniz kullanıcıları gizleme
  • Favoriler: Giriş yapan kullanıcıların favori kişileri işaretlemesi
  • Excel: Dışa aktarma (XLSX) ve içe aktarma (ofis-rehberi eklentisindeki PhpSpreadsheet kullanılır)
  • Shortcode'lar: [kisi_rehberi] (liste + arama), [kisi_rehberi_arama] (sadece arama kutusu)
  • Embed: Harici sayfalara gömülebilir rehber URL’i
  • Görünüm: Tablo veya kart modu; mobilde kart görünümü
  • Önbellek: Liste 1 saat transient ile önbelleklenir

Gereksinimler

  • WordPress 5.0+
  • PHP 7.4+

Opsiyonel:

  • BuddyPress: Profil alanları (Dahili, Departman, Bölüm, Lokasyon, Unvan, Görevi) ile senkron
  • ofis-rehberi eklentisi: Excel dışa/içe aktarma için ofis-rehberi/vendor/autoload.php (PhpSpreadsheet) kullanılır; yoksa Excel özelliği devre dışı kalır

Kurulum

  1. Depoyu klonlayın veya indirin:
    git clone https://github.com/burakcaylak/kisi-rehberi.git
  2. kisi-rehberi klasörünü wp-content/plugins/ içine kopyalayın.
  3. Yönetim panelinde Eklentiler → Kişi Rehberi → Etkinleştir.
  4. Kişi Rehberi → Ayarlar üzerinden roller, görünüm modu ve varsayılan avatar’ı ayarlayın.

Kullanım

Shortcode'lar

Shortcode Açıklama
[kisi_rehberi] Tam rehber: arama kutusu + tablo veya kart listesi
[kisi_rehberi_arama] Sadece arama kutusu (AJAX ile sonuç listesi)

Örnek – Kart görünümü:

[kisi_rehberi gorunum=kart]

Embed URL

Harici sayfalara gömülebilir tam sayfa rehber:

https://siteniz.com/?kisi_rehberi_embed=1

Yönetim

  • Kişi Rehberi → Kişi Listesi: Tüm kişileri görüntüleme, düzenleme, gizleme, özel kişi ekleme/silme, Excel dışa/içe aktarma.
  • Kişi Rehberi → Ayarlar: Roller, “sadece dahili olanlar”, görünüm modu (tablo/kart), varsayılan avatar, cache temizleme, tabloları oluşturma, “Profillere İşle” (user_meta + BuddyPress).

Veritabanı tabloları

Eklenti şu tabloları oluşturur:

  • {prefix}kisi_rehberi_ozel – Özel kişiler
  • {prefix}kisi_rehberi_gizli – Gizlenecek kullanıcı ID’leri
  • {prefix}kisi_rehberi_favoriler – Kullanıcı bazlı favori kişi ID’leri

Dosya yapısı

kisi-rehberi/
├── assets/
│   ├── style.css   # Frontend stilleri
│   ├── script.js   # Frontend script (gerekirse)
│   └── index.php
├── index.php
├── kisi-rehberi.php   # Ana eklenti dosyası
└── README.md

Excel dışa/içe aktarma

Excel özelliği, ofis-rehberi eklentisindeki PhpSpreadsheet kütüphanesine bağlıdır.
wp-content/plugins/ofis-rehberi/vendor/autoload.php mevcutsa Excel dışa aktarma ve içe aktarma çalışır; yoksa bu menü/butonlar kullanılamaz.

Lisans

GPL v2 veya üzeri. Detay için WordPress License sayfasına bakın.

Katkıda bulunma

  1. Bu depoyu fork edin.
  2. Yeni bir dal oluşturun: git checkout -b feature/yeni-ozellik
  3. Değişikliklerinizi commit edin: git commit -m 'Yeni özellik eklendi'
  4. Dalı push edin: git push origin feature/yeni-ozellik
  5. Bir Pull Request açın.

İletişim

Yazar: Ahmet Burak Çaylak
Depo: github.com/burakcaylak/kisi-rehberi