# Başlangıç

Portfaria ile kafanızda kalan bütün sorular ve genel bilgiler edinebileceğiniz bir giriş sayfasıdır.

[Lisans API Kullanımı](/hyper/lisans-api-kullanimi)

[Resim Boyutları](/hyper/resim-boyutlari)


# Resim Boyutları

Sitenizde yükleyeceğiniz resimlerin boyutları

### Tema » Ayarlar

**Favicon** **»** `64x64`

**Header Logo »** `50x50`

**Hero Arkaplan »** `1920x1080`

**Hero Fotoğraf »** `500x500`

**Son Satılanlar Figür »** `150x150`

### Haber

**Resim »** `640x360`

### Ürün

**Resim »** `640x360`

### Ana Sayfa » Portfolyo

**Resim »** `540x540`


# Lisans API Kullanımı

Eğer lisanslı ürün satacaksanız, lisans kontrolü yapabilmeniz için yazılımın içine gömülü apiyi nasıl kullanabileceğinizi anlatan bir sayfadır.

## API Nedir?

Açılımı Application Programming Interface olan bir terimdir. Internet sayfalarının veya çeşitli uygulamaların birbirlerine istek göndererek veri toplayabilmesini sağlar.

### Örnek API İsteği Kodları

#### PHP

<pre class="language-php"><code class="lang-php"><strong>// Ürün ID'si - Örnek 1 verelim.
</strong>$productID = 1;
// Çalıştırılan sunucunun domain (alan adı)'nı alacaktır.
$domain = $_SERVER['SERVER_NAME'];
// URL
$url = "https://siteniz.com/API/domainCheck?productID=".$productID."&#x26;domain=".$domain;
<strong>$request = json_decode(file_get_contents($url), true);
</strong><strong>
</strong><strong>// Lisans Kontrolü
</strong><strong>if($request['status'] == false &#x26;&#x26; $request['code'] == 'expired') {
</strong><strong>    // Lisansın süresi bitmiş
</strong><strong>    // Burada die("Lisansınızın süresi bitmiş");
</strong>    // yazdırabilirsiniz.
}elseif($request['status'] == false &#x26;&#x26; $request['code'] == 'no') {
    // Lisans bulunamadı
    // Burada die("Lisans yok");
    // yazdırabilirsiniz.
}    

// Eğer üstteki iki koşuldanda geçerse lisans var demektir.
// Eğer lisansı varsa diye bir kontrol yapmanıza gerek yok.
// Zaten lisansı yoksa yapacağınız işlem sitenin çalışmasını durdurmaktır.
</code></pre>

#### JavaScript

<pre class="language-javascript"><code class="lang-javascript"><strong>// Axios kütüphanesini kullanacağız.
</strong><strong>import axios from 'axios'
</strong>
let ip = "127.0.0.1";
// Ürüne 1 diyelim.
let productID = 1;
let url = "https://hyper.portfaria.com/API/ipCheck?productID="+productID+"&#x26;ip="+ip;

axios.get(url)
    .then((res) => {
        if(res.data.code === "expired") {
            // Lisansın süresi bitmiş
        }else if(res.data.code === "no") {
            // Lisans bulunamadı
        }
    })
</code></pre>

## Nereye istek atmalıyız?

#### Alan Adı (Domain) Kontrol APIsi

<mark style="color:blue;">`GET`</mark> `https://alanadınız.com/API/domainCheck?productID=:id:&domain=:domain:`

:id: = Ürün IDsi\
:domain: = Alan Adı

#### Query Parameters

| Name                                     | Type    | Description |
| ---------------------------------------- | ------- | ----------- |
| id<mark style="color:red;">\*</mark>     | Integer |             |
| domain<mark style="color:red;">\*</mark> | String  |             |

{% tabs %}
{% tab title="200: OK Lisans bulundu!" %}

```json
{
  "status": true,
  "message": "Lisans bulundu!"
}
```

{% endtab %}

{% tab title="200: OK Lisans bulunamadı!" %}

```javascript
{
  "status": false,
  "code": "no",
  "message": "Lisans bulunamadı!"
}
```

{% endtab %}

{% tab title="200: OK Lisansın süresi bitmiş!" %}

```javascript
{
  "status": false,
  "code": "expired",
  "message": "Lisansın süresi bitmiş!"
}
```

{% endtab %}
{% endtabs %}

#### IP Adresi (IPv4) Kontrol APIsi

<mark style="color:blue;">`GET`</mark> `https://alanadınız.com/API/ipCheck?productID=:id:&ip=:ip:`

:id: = Ürün IDsi\
:ip: = IP Adresi (IPv4)

#### Query Parameters

| Name                                 | Type    | Description |
| ------------------------------------ | ------- | ----------- |
| id<mark style="color:red;">\*</mark> | Integer |             |
| ip<mark style="color:red;">\*</mark> | String  |             |

{% tabs %}
{% tab title="200: OK Lisans bulundu!" %}

```json
{
  "status": true,
  "message": "Lisans bulundu!"
}
```

{% endtab %}

{% tab title="200: OK Lisans bulunamadı!" %}

```javascript
{
  "status": false,
  "code": "no",
  "message": "Lisans bulunamadı!"
}
```

{% endtab %}

{% tab title="200: OK Lisansın süresi bitmiş!" %}

```javascript
{
  "status": false,
  "code": "expired",
  "message": "Lisansın süresi bitmiş!"
}
```

{% endtab %}
{% endtabs %}


# Kurulum

Bu sayfada Hyper yazılımını nasıl kurabileceğinizi öğrenebilirsiniz.

Hyper yazılımının çalışması için PHP versiyonunun **7.4** olması ve eval() fonksiyonunun aktif olması gerekiyor.

### Gereksinimler

* [x] PHP 7.4
* [x] eval() Fonksiyonu
* [x] MariaDB 10

### Önerilen Hostingler

* Sofixa
* Hosting.com.tr
* Güzel Hosting
* Rabisu

Plesk ve Cpanel için kurulum yazısı eklenecektir...


# v.1.3.3

Hyper Webscriptinin v1.3.3 sürümünde eklenen / düzeltilen özellikler

## Duyuru Sistemi

* [x] Popup duyurular eklendi, ziyaretçileriniz siteye ilk girişlerinde duyurularınızı görecek

## Güvenlik

* [x] İki Adımlı Doğrulama eklendi (2FA)
* [x] reCaptcha Güvenlik Koruması Eklendi

## Tema

* [x] Anasayfada Slider sistemi eklendi
* [x] Mağaza'ya Filtreleme sistemi getirildi
* [x] Mağaza'ya Kategori içi Kategori oluşturabilme özelliği getirildi
* [x] Bazı temasal sorunlar düzeltildi

## Mağaza

* [x] Ücretsiz Ürün ekleme özelliği getirildi
* [x] Filtreleme Sistemi

## Oturum Sistemi

* [x] Beni Hatırla özelliği getirildi
* [x] Mobildeyken Sidebar menüdeki Oturum Aç, Hesap Oluştur butonlarının gözükmeme sorunu düzeltildi

## Fiyatlandırma

* [x] Hyper Web Script ürününün fiyatlarında değişikliğe gidildi

## Demo

{% embed url="<https://hyper.portfaria.com>" %}


# v1.3.2

Hyper Webscriptinin v1.3.2 güncellemesinde eklenen / düzeltilen özelliklerin listesi

## Yardım Merkezi

* [x] Müşterilerinizin destek talebi açmasına gerek kalmadan onlara belirli konular açarak forum tarzı yardımlarda bulunabilirsiniz

## Sıkça Sorulan Sorular

* [x] Yardım Merkezi üzerinde sıkça sorulan sorular ekleyebilirsiniz

## İndirim Sistemi

* [x] Artık seçtiğiniz ürünlere belirli tarihler ile indirim uygulayabileceksiniz
* [x] Kimlerin indirim alamayacağını seçebilirsiniz
* [x] Toplu indirim uygulayabilme

## Mağaza

* [x] Liste dışı ürün ekleyebilme\
  \- Bu özellik ile sadece link üzerinden erişebilirler.

## Mağaza'da Değişiklikler

* Artık Seçenekli ürün dışında tüm ürünlerin alışı normal olup, lisanslı ürünlerin aktifleşmesi için müşteri panelinden lisans tanımlamaları gerekmektedir.

## Tema'da Değişiklikler

* Default Hyper temasında bir çok değişikliğe gidildi
* Mağaza & Header & Yardım Merkezinde **arama butonları** eklendi

## Bugfixler - (Düzeltilenler)

* Yönetim Paneli Collapse (Sidebar) kapatıp açma butonu düzeltildi.
* Yönetim Panelinden lisans ekleme / düzenleme sistemindeki hatalar giderildi.
* Yönetim Panelindeki E-Posta onaylamayanlar için hali hazırda olan sistemdeki bazı hatalar giderildi.
* Yönetim Panelindeki Koyu / Açık Tema değiştirememe özelliği düzeltildi.
* Bakiye Yüklerken belirlenen komisyon miktarının bakiyeye eklenmesi düzeltildi.

## Değişen Dosyalar

yakında eklenecek...

## Demo

{% embed url="<https://hyper.portfaria.com>" %}


# v1.3

Hyper Web Scriptinin 1.3 güncellemesinde gelen / çözülen özelliklerin listesi.

## Google - Discord oAuth

* [x] Yeni gelen özellik ile artık sitenizde tek tık ile google veya discord hesabınızla kayıt olup, giriş yapabilirsiniz.

Detaylı bilgi için [Nasıl bağlayabilirim?](/oauth/nasil-baglayabilirim) sayfasını ziyaret edin.

## Destek Talebi Sistemi

* [x] Artık sitenizde kayıt olmuş üyeler sizlere destek talebi üzerinden ulaşabilecek.
* [x] Müşterinin destek talebine cevap verdiğiniz zaman bilgilendirici email gönderilir.

## Şifremi Unuttum

* [x] Uzun zamandır beklenen şifremi unuttum sistemi artık çıktı!

## E-Posta Doğrulama

* [x] E-Posta doğrulama sistemi eklendi.
* [x] E-Postasını doğrulamamış kişilerin yapamayacağı işlemleri Yönetim Panelinden düzenleyebiliyorsunuz.

## Yeni Tema Sistemi

* [x] Yeni gelen tema sistemi ile sizde kendi temanızı geliştirip satışını yapabilirsiniz.

[Tema Sistemi](/tema-gelistirin/tema-sistemi)'nden detaylı bilgi alabilirsiniz.

## Ürün Tipi

* [x] Seçenekli Ürün

- Seçenekli ürün ile eklediğin ürüne soru ekleyebilirsin.
- Örneğin: Tasarım diye bir ürün ekledik, Yönetim Panelinden soru ekliyoruz: ".psd olarak ister misiniz? (+30₺)", Kişi soruyu evet olarak cevaplarsa ona ikinci bir soru sorabiliyorsunuz örneğin, "Size nasıl ulaşabiliriz?". O aşamayı da geçince ürün 20₺ ise +30₺ = 50₺ öder

## Mağaza

* [x] Ürün Yorumları

- Müşteriler satın aldığı ürüne yorum yazıp bunu 1-5 yıldız arası değerlendirebilir.

* [x] Manuel / Otomatik Teslimat

- Manuel teslimat seçili olduğu zaman müşteri e-pin ürününü satın aldığı zaman para hesabından çekilir fakat bir yönetici tarafından onaylanmasını bekler. Onaylandığı zaman hesap teslim edilir.
- Otomatik teslimat seçili olduğu zaman aldığı e-pin ürünü stoktan direkt olarak çekilip teslim edilir.

* [x] Ödeme Komisyonu

- Artık müşterilerinize komisyon yansıtabilirsiniz.
- Örneğin Ödeme aldığınız firma sizden %2.69 komisyon kesiyor ise, bunu müşteriye yansıtabilirsiniz.

* [x] Tasarım Güncellemesi
* [x] En Çok İncelenen Ürünler

## SMTP - Mail Sistemi

Artık siteniz üzerinden herhangi bir işlemde müşteriye bilgilendirici email atabileceksiniz.

Sistem otomatik çalışır.

***

* [x] Hesap Oluşturma
* [x] Ürün Satın Alma
* [x] E-Mail Doğrulama
* [x] Şifremi Unuttum
* [x] Sipariş İptali
* [x] Toplu Duyuru
* [x] Destek Talebi Bildirimi
* [x] Ban

***

SMTP Ayarlamak için [SMTP](/smtp/nasil-baglayabilirim) sayfasını ziyaret edin

## Hemen Hyper satın alın!

{% embed url="<https://www.portfaria.com/price>" %}
Fiyatlara yakın zamanda zam gelecektir.
{% endembed %}

## Demo Sayfası

{% embed url="<https://hyper.portfaria.com>" %}


# v1.2

Hyper WebScriptinin v1.2 güncellemesinde yeni eklenenler ve yapılan fixlerin listesi.

### Sepet Sistemi

* [x] Sepet Sistemi eklendi!

- Ziyaretçilerin mağazadaki ürünleri sepete ekleyip toplu alım yapabilmesini sağlayan gelişmiş bir sistemdir.

### İndirim Kuponu

* [x] Kupon Sistemi eklendi!

- Müşterilerinize %lik biçimlerde indirim sağlayabilmeniz için indirim kuponu sistemi eklendi!
- &#x20;İndirimler sepetteki toplam tutar üzerinden sağlanır.

### Rol Sistemi

* [x] Rol Sistemi eklendi!

- Yetkililerinize veya istediğiniz kişiye herhangi bir rol verebileceksiniz
- Oluşturduğunuz rollere her işlemden bir yetki atayabileceksiniz.

### Ödeme Yöntemleri

* [x] Vallet (vallet.com.tr)
* [x] Papara
* [x] IBAN

### Satın Alım

* [x] Bakiyesiz Satın Alım

- Müşterileriniz artık bakiye yüklemek zorunluluğunda değil!
- Sepete ekledikleri ürünü ister bakiye ister direkt kartları ile beraber satın alabilecekler.

### SEO Geliştirmeleri

* [x] Sitemap.xml geliştirildi
* [x] Bir çok açıdan seo geliştirmeleri yapıldı

### Mağaza Geliştirmeleri

* [x] Her ürün için ayrı sayfa özelliği eklendi

### Fixler

* [x] Müşteri Paneldeki ürün listeleme sorunu çözüldü.
* [x] Ana Sayfaki Neler Sağlıyorum ve Referanslarımdaki ayrım sorunu çözüldü.
* [x] Yönetim Paneli > Tema > Ayarlar'da resim yüklemeden Kaydet butonuna tıklayınca "Dosya yüklenemedi. İşlem Sonlandırıldı" hatası çözüldü.
* [x] Yönetim Paneli > Lisans'daki hatalar çözüldü.

### Demo:

{% embed url="<https://hyper.portfaria.com>" %}

### Hemen Hyper satın alın!

{% embed url="<https://portfaria.com/price>" %}
Aylık - Yıllık - Ömür Boyu seçenekleri ile
{% endembed %}


# v1.1

Hyper WebScriptinin v1.1 güncellemesinde yeni eklenenler ve yapılan fixlerin listesi.

### Referans Sistemi

* [x] Logo Özelliği\
  Bu özellik ile beraber referanslara logo ekleyebileceksiniz.

### Ödeme Yöntemi

* [x] Paymax - [www.paymax.com.tr](http://www.paymax.com.tr)
* [x] Shipy - [www.shipy.net](http://www.shipy.net)

### Sistem

* [x] Bakım Modu
* [x] Kar Efekti
* [x] Toplu Stok Ekleme
* [x] Kullanıcıya Ürün Gönderebilme
* [x] /discord Özelliği\
  Ziyaretçi sitenizde /discord'a gittiği zaman otomatik sunucunuza yönlendirir.
* [x] İstatistikler Kutusu\
  Anasayfa'da toplam bulunan kullanıcı, müşteri (en az 1 adet ürün almış) ve ürünlerin sayısının gösterildiği bir kutu.
* [x] Footer Açıklaması\
  Ayarlar > Genel'den footerda gözükmesi için yazı yazabilirsiniz.
* [x] LazyLoad\
  Sitede bir resme ulaşamadığı zaman veya site yüklenirken yükleniyor... animasyonu gözükür.

### Webhooklar çoğaltıldı!

* [x] Mağaza Kullanım Webhook
* [x] Bakiye Yükleme Webhook
* [x] Mesaj Gönderim Webhook
* [x] Yorum Webhook

İndirim Kuponu, Sepet Sistemi gibi özellikler diğer güncelleme için planlandı.

## Demo Sayfası

{% embed url="<https://hyper.portfaria.com>" %}

<figure><img src="https://www.hizliresim.com/984e27c" alt=""><figcaption></figcaption></figure>

### <br>

<figure><img src="https://www.hizliresim.com/984e27c" alt=""><figcaption></figcaption></figure>


# Tema Sistemi


# Nasıl bağlayabilirim?

Yakında güncellenecek.


# Nasıl bağlayabilirim?


# Google

Yakında güncellenecek.


# Discord

### Uygulamanızı oluşturun

1. `https://discord.com/developers/applications` sayfasına giriş yapın.
2. ![](/files/SEXo0O22mNAGx76mENnW) Butonuna basınız.
3. Name\* kısmına sitenizin adını girin.
4. Oluşturduktan sonra **OAuth2** > Genel yerine girdikten sonra önünüzdeki Client ID ve Client Secret tokenlerini sitenizde **Yönetim Paneli > Ayarlar > Sistem** yerine gireceksiniz.
5. Girdikten sonra discord sekmesine geri dönün.
6. Redirects (Yönlendirmeler) yerinden yeni bir yönlendirme ekleyin.
7. https\://**siteniz.com**/Auth/discordAuth olarak girin: siteniz.com yerine kendi sitenizi gireceksiniz. Örneğin: <https://hyper.portfaria.com/Auth/discordAuth>
8. İşlem tamam, artık discord ile giriş aktif oldu.


