OpenClassify

OpenClassify is the extensible and most advanced open source classified app build with Laravel.

Core Modules

advs-module cats-module default-theme defaultadmin-theme json-field_type location-module media-field_type profile-module single-file_type

Extensions used by OpenClassify to install to ubuntu php 7.2

sudo apt-get install php7.2-sqlite

sudo apt-get install php7.2-bcmath

Docker Enviroment

Requirements

• Git
• Docker
• Docker Compose

Check if docker-compose is already installed by entering the following command :

which docker-compose

Check Docker Compose compatibility :

• Compose file version 3 reference

The following is optional but makes life more enjoyable :

which make

On Ubuntu and Debian these are available in the meta-package build-essential. On other distributions, you may need to install the GNU C++ compiler separately.

sudo apt install build-essential

Running The application

1. Start the application :

   sudo docker-compose up -d
   

   Please wait this might take a several minutes...

   sudo docker-compose logs -f # Follow log output
   

   Add these line in your .env file ...

   # Nginx
   NGINX_HOST=localhost
   
   # PHP
   
   # See https://hub.docker.com/r/nanoninja/php-fpm/tags/
   PHP_VERSION=latest
   
   # MySQL 
   MYSQL_VERSION=5.7.22  //Keep this up as your requirements
   MYSQL_HOST=mysql
   MYSQL_DATABASE=your_db_name
   MYSQL_ROOT_USER=root
   MYSQL_ROOT_PASSWORD=root
   MYSQL_USER=dev
   MYSQL_PASSWORD=dev
   

   Replace these line in your .env file ...

    DB_HOST=mysql
    DB_PORT=3306
    DB_DATABASE=your_db_name
    DB_USERNAME=root
    DB_PASSWORD=root
   

2. Open your favorite browser :

   • http://localhost:8000
   • http://localhost:8080 PHPMyAdmin (username: dev, password: dev)

3. Stop and clear services

   sudo docker-compose down -v
   

---

## Module ekleme

Visiosoft -> bulunduğu klasör adı. Herhangi bir şey olabilir Advs -> modülün adı

— php artisan make:addon visiosoft.module.advs

Bundan sonra

Addons/default/visiosoft/advs-module klasörü oluşacaktır.

yukarıdaki dosya yolunda migration klasörünün içerisinde otomatik oluşan bir migration dosyası olacak.

Bu örnek için tarih__visiosoft.module.advs__create_advs_fields.php

Bunun içine tüm modülde kullanacak fieldları girilmeli

Örnek olarak

protected $fields = [
	'name' => 'anomaly.field_type.text',
    'category' => [
        'type' => 'anomaly.field_type.relationship',
        'config' => [
            'related' => CategoryModel::class
        ]
    ]
]

Daha sonra önce ana tablo ve sonrasında diğer tablolar eklenmeli. Sıra önemli yanlış sırada route sapıtıyor.

php artisan make:stream advs advs

İle ana kategori dosyaları ve migration ı yaratılıyor daha sonra

php artisan make:stream categories advs

İle bağlı olan diğer kısım

Oluşan migrationlar içerisine field özellikleri giriliyor.

Örn:

protected $stream = [
    'slug' => 'advs',
     'title_column' => 'name',
     'translatable' => true,
     'trashable' => false,
     'searchable' => false,
     'sortable' => false,
];

/**
 * The stream assignments.
 *
 * @var array
 */
protected $assignments = [
    'name' => [
        'translatable' => true,
        'required' => true,
    ],
    'slug' => [
        'unique' => true,
        'required' => true,
    ],
    'advs_desc',
    'category',
    'price',
    'currency',
    'online_payment',
    'stock',
    'files'
];

Bu bölümler hazır olduktan sonra

Php artisan addon:install advs

İle module sisteme yükleniyor.

Modülde değişiklik yapılacaksa eğer

Öncelikle php artisan addonn:uninstall advs

Yazılarak modül silinip değişiklikten sonra tekrar yüklenmeli

Multilanguage için öncelikle sitenin settings->system bölümünden istenilen diller aktif edilmeli.

static bölümlerin translate (laravel gibi) her modülün içinde olan resources/lang/ içinden yapılıyor.

Dinamik alanlar ise ayarlardan multilanguage aktifleştirilince her inputun labelinde bulunan dropdown ile yapılıyor

Proje kurulurken dikkat edilmesi gereken husus

Gelistirme sureci icin proje kurulurken, application name in default olarak ayarlanmasi gerekiyor, bu sekilde ayarlanmadigi takdirde addonlar gozukmeyecektir.

Custom view lar ile ilgili...

Custom view tanimlayip modulun icinden ulasilmak istenildiginde yapilmasi gerekenler:

1. addons/default/visiosoft/modulename/resources/views altina custom bir view dosyasi aciyoruz
2. controllerdan bu view a ulasmak icin $this->view->make('visiosoft.module.modulename::modulename/list'); komutunu kullanabiliriz, hata vermemesi icin kullanilan controller'in PublicController class ina extends edilmesi gerekebilir.
3. kodun visiosoft.module.modulename kismi, alinda addons/default/visiosoft/modulename/resources/views kismini isaret etmektedir.

## manuel addon ekleme

klasör addon altına kopyalanır ve mutlaka composer dump-autoload yapılmalıdır.

## modül seed yüklemek için

php artisan db:seed --addon=modül_adi

## modül ve seed yüklemek için

php artisan addon:install modül_adi --seed

OR

php artisan addon:reinstall modül_adi --seed

Ajax Loader Eklemek

İşlem süresinde kullancıyı loader eklentisi göstererek hem şık bir görüntü hemde boş veri göstermemiş oluruz. Loader Ajax Global Fonksiyonu Aşağıdaki örnekte verilmiştir.

Örn:

$.ajax({
        type: 'get',
        url: '/class/getcats/'+ divId,
        success: function (response) {
            hideLoader() // işlem bşarılı olursa loader gizle
        },
        beforeSend: function () {
            showLoader() // işlem süresince loader göster
        }
    })
    
     protected $options = [
            'redirect' => '/admin/cloudsite',
            'success_message'   => 'visiosoft.module.cloudsite::message.created_site.message',
        ];

Önyüzde Uyarılar

İşlem sonucunda uyarı göstermek istenebilir.Uyarılar builder'da veya Redirect olarak 2 farklı şekilde gönderilebilir.

FormBuilder Örn:

     protected $options = [
            'redirect' => '/admin/cloudsite',
            'success_message'   => 'visiosoft.module.cloudsite::message.created_site.message',
        ];

Controller/Redirect Veya Controller/Return Örn:

     return redirect('admin/cats')->with('success', ['Message1.','Message2',...]);
     
     //OR
                                  ->with('error', ['Message1.','Message2',...]);
     //OR
                                  ->with('warning', ['Message1.','Message2',...]);
     //OR
                                  ->with('info', ['Message1.','Message2',...]);          

Önyüzde Form Builder ileOluşturulan bir form elemanına required özelliği atama

currency Örn:

     <div class="col-sm-3 col-xs-6">
         {{ form.fields.currency.setAttributes({'required' :true,}).input|raw }}
     </div>

Table Builder query kullanımı

//AdvsTableBuilder.php     
    public function onQuerying(Builder $query)
        {
            $query->where('slug', "!=", NULL);
        }