Difference between revisions of "VbzCart/install"

from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
Jump to: navigation, search
(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.git into a folder of your choice, which we'll call <vbz-base>.
  • Copy the <vbz-base>/config folder 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>/examples folder to <local-config>/local.
  • Modify each file to match your local environment, according to instructions in each file.
  • Optional: modify files in <local-config>/portable as needed.
  • Install Ferreteria
  • Set up database and tables (instructions to be written)
  • Link or copy the <local-config>/portable/index.php file to your public web folder.
  • Link or copy the <vbz-base>/static folder 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