Difference between revisions of "VbzCart/install"
(another link to create) |
|||
| Line 13: | Line 13: | ||
* Link or copy the <code>{{arg|local-config}}/portable/index.php</code> file to your public web folder. | * Link or copy the <code>{{arg|local-config}}/portable/index.php</code> file to your public web folder. | ||
* Link or copy the <code>{{arg|vbz-base}}/static</code> folder to your public web folder. | * Link or copy the <code>{{arg|vbz-base}}/static</code> folder to your public web folder. | ||
| + | * Create the public web ufiles folder | ||
==Woozle's setup== | ==Woozle's setup== | ||
Some specifics of how I usually set things up these days, giving examples from the dev instance I'm setting up as I type this (see [[User:Woozle/setups/vdomain]] for definitions): | Some specifics of how I usually set things up these days, giving examples from the dev instance I'm setting up as I type this (see [[User:Woozle/setups/vdomain]] for definitions): | ||
| Line 35: | Line 36: | ||
* cd .. | * cd .. | ||
* ln -rs git/VbzCart/static ~/public_html/static | * ln -rs git/VbzCart/static ~/public_html/static | ||
| + | * mkdir ufiles | ||
| + | * cd ufiles | ||
| + | * mkdir pub | ||
| + | * ln -rs pub ~/public_html/ufiles | ||
'''3.''' Modify the files in <code>vbzcart/local</code> as needed to match your local environment. (If you use the same structure I'm using here, <code>index.php</code> will not need modification.) This will require having a database set up so you can get the appropriate connection credentials to put in <code>creds.php</code>. | '''3.''' Modify the files in <code>vbzcart/local</code> as needed to match your local environment. (If you use the same structure I'm using here, <code>index.php</code> will not need modification.) This will require having a database set up so you can get the appropriate connection credentials to put in <code>creds.php</code>. | ||
At this point, I ''think'' you should be able to point a browser at the domain and get something, even if it's only errors that you'll need to look at in order to figure out what's left to configure. | At this point, I ''think'' you should be able to point a browser at the domain and get something, even if it's only errors that you'll need to look at in order to figure out what's left to configure. | ||
| + | |||
| + | TODO: configure .htaccess to properly intercept virtual URLs | ||
Revision as of 13:45, 12 October 2019
Prerequisites: Linux, PHP 7, MySQL-workalike, Apache.
This page will eventually need to include a lot more information, but for now the basic setup procedure is:
- Clone the VbzCart Git repository at
[git@gitlab.com:woozalia/VbzCart.gitinto a folder of your choice, which we'll call <vbz-base>. - Copy the
<vbz-base>/configfolder to a location outside of<vbz-base>.- We'll call this new location <local-config>.
- My standard location for this is
/home/vbz/site/config/vbzcart
- Rename the
<local-config>/examplesfolder to<local-config>/local. - Modify each file to match your local environment, according to instructions in each file.
- Optional: modify files in
<local-config>/portableas needed. - Install Ferreteria
- Set up database and tables (instructions to be written)
- Link or copy the
<local-config>/portable/index.phpfile to your public web folder. - Link or copy the
<vbz-base>/staticfolder to your public web folder. - Create the public web ufiles folder
Woozle's setup
Some specifics of how I usually set things up these days, giving examples from the dev instance I'm setting up as I type this (see User:Woozle/setups/vdomain for definitions):
Preparation
You'll need to have <$USER>'s account set up with an ssh key that can access GitLab. At least, I think that's the requirement. It might be more GitLab-project-specific.
Steps
1. Install Ferreteria (you can actually do this at any point, but it may be easier to do it first).
2. Run these commands in a terminal on your web server (you can skip mkdir wherever the folder already exists):
- cd <$HOME>
- su <$USER>
- mkdir site
- cd site
- mkdir git
- git clone git@gitlab.com:woozalia/VbzCart.git
- cd ..
- mkdir config
- cd config
- cp -R ../git/VbzCart/config vbzcart
- mv vbzcart/examples vbzcart/local
- ln -rs vbzcart/local/index.php ~/public_html/index.php
- cd ..
- ln -rs git/VbzCart/static ~/public_html/static
- mkdir ufiles
- cd ufiles
- mkdir pub
- ln -rs pub ~/public_html/ufiles
3. Modify the files in vbzcart/local as needed to match your local environment. (If you use the same structure I'm using here, index.php will not need modification.) This will require having a database set up so you can get the appropriate connection credentials to put in creds.php.
At this point, I think you should be able to point a browser at the domain and get something, even if it's only errors that you'll need to look at in order to figure out what's left to configure.
TODO: configure .htaccess to properly intercept virtual URLs