wadeshuler/yii2-members-system

Yii 2 Advanced Project Template

v2.2.0 2019-04-13 22:06 UTC

README

This repo has had a major update! Try it out :)

My members system based on the Yii2 advanced framework. Grunt, LESS/SASS, TS, Backup, reset yii, clear cache, shared login, and more...

This has been built on top of the Yii2 Advanced App version 2.0.17, so it is way more up to date than older version of this repo.

New Features

  • Affiliate links and baseline for supporting landing pages.
  • View sponsor and referrals
  • Updated separate admin/super/root privileges

Features

  • Grunt asset handling (and other helpful commands to backup, reset yii, etc)
  • AdminLTE theme on frontend & backend apps
  • mainsite is the default Yii2 template improved with Grunt asset handling
  • 3 separate sections: admin (backend), users (frontend), and mainsite (for your custom homepage)
  • admins and users are completely separated (sessions, cookies, db table, etc)
  • Shared login between mainsite and users (frontend) apps
  • Database migrations (separate user and admin tables, user profile, basic user settings)
  • Extended User Component to easily add to Yii::$app->user->something
  • Affiliate links and baseline for supporting basic landing pages.
  • View sponsor and referrals
  • Updated separate admin/super/root privileges
  • and probably a few more things, so poke around the code :)

Installation

composer create-project wadeshuler/yii2-members-system yii2-members-system

Once Composer has done it's thing, you need to run a few commands before you can play.

composer install
npm install
./init
grunt build

Then, create the database yii2-members-system. If you already have a database with that name, choose another name. Assign a user to that database. Then update common/config/main-local.php with your database information.

Now you can migrate:

./yii migrate

Configuring

Out of the box, the paths would be like so:

http://localhost/yii2-members-system/mainsite
http://localhost/yii2-members-system/frontend
http://localhost/yii2-members-system/backend

It is highly recommended to setup VHOSTS and point the domain (even if local) to the web directories. I prefer to map yii2-members-system.local to mainsite/web, user.yii2-members-system.local to frontend/web, and admin.yii2-members-system.local to backend/web. Obviously, you can use whatever domain name you want here.

If you are configuring this locally (XAMPP or WAMP), you will create fake domains. I typically do .local domains for my local emulation. Some people do .local, but I strongly recommend you don't use .com or any real domain extension.

To create this domain, edit your hosts file and point your localhost IP to it.

Mac, Unix: sudo nano /etc/hosts

Enter your password. At the bottom of the hosts file, add:

127.0.0.1       yii2-members-system.local

Then press CTRL + o to save and CTRL + x to exit. Restart your web server.

Windows: Open C:\Windows\system32\etc\hosts with your preferred text editor.

If your on Windows 10 and have issues getting the hosts file to save, do this. Copy the hosts file and paste it on your desktop. Edit the one on your desktop and save it. Then copy it from your desktop to the etc directory, confirm to replace.

Here is an example of my VHOSTS from my local XAMPP. You may need to adjust the DocumentRoot path:

    <VirtualHost *:80>
        ServerName yii2-members-system.local
        ServerAlias www.yii2-members-system.local
        DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs/yii2-members-system/mainsite/web"
        ErrorLog "logs/mainsite.yii2-members-system.local-error_log"
        CustomLog "logs/mainsite.yii2-members-system.local-access_log" common
    </VirtualHost>

    <VirtualHost *:80>
        ServerName yii2-members-system.local
        ServerAlias users.yii2-members-system.local
        DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs/yii2-members-system/frontend/web"
        ErrorLog "logs/users.yii2-members-system.local-error_log"
        CustomLog "logs/users.yii2-members-system.local-access_log" common
    </VirtualHost>

    <VirtualHost *:80>
        ServerName yii2-members-system.local
        ServerAlias admin.yii2-members-system.local
        DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs/yii2-members-system/backend/web"
        ErrorLog "logs/admin.yii2-members-system.local-error_log"
        CustomLog "logs/admin.yii2-members-system.local-access_log" common
    </VirtualHost>

Restart your web server and access your new domains in your browser.

If you have issues, please check the issues tab.

Latest Stable Version License composer.lock available