hdushku / yii2-members-system Goto Github PK

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

• 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
• Extended Controller (BaseController) ready if you need it
• and probably a few more things, so poke around the code :)

You can see it here:

http://yii2memberssystem-wadeshuler.rhcloud.com

http://yii2memberssystem-wadeshuler.rhcloud.com/members

username: user
password: 123456

http://yii2memberssystem-wadeshuler.rhcloud.com/admin

username: root (also, `super` and `admin`)
password: 123456

Please Note: The demo is just an example. I have "members" as a symbolic link from /mainsite/web/members pointing to /frontend/web and a symbolic link from /mainsite/web/admin pointing to /backend/web. These symbolic links are not included and are created during my OpenShift action hooks. So unless you push to OpenShift, they won't work. You will need to create your own symbolic links, or you can point sub-domains to the web directories.

I have mainsite as the main homepage (ie: www.site.com). Then you could create a users sub-domain and point it to /frontend/web and an admin sub-domain pointed to /backend/web. See the VHOSTS example below under CONFIGURING.

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

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.dev to mainsite/web, user.yii2-members-system.dev to frontend/web, and admin.yii2-members-system.dev 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 .dev 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.dev

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.dev
    ServerAlias www.yii2-members-system.dev
    DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs/yii2-members-system/mainsite/web"
    ErrorLog "logs/mainsite.yii2-members-system.dev-error_log"
    CustomLog "logs/mainsite.yii2-members-system.dev-access_log" common
</VirtualHost>

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

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

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

All you have to do is follow the comments in mainsite/config/main.php and frontend/config/main.php and edit the URL Manager Aliases in common/config/bootstrap.php.

In the config files (xxx/config/main.php) you will see a few comments, like:

// uncomment for sub-domain use
// comment out the following line for sub-domain use
// uncomment the following line for sub-domain use

Follow those comments in the config files to know what needs to be on or off, for sub-domain use.

If you do not edit these files, you will get errors when you are using sub-domains!

If you have issues, please check the issues tab.