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 Jump to search
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
===Preparation===
 +
* '''Prerequisites''': Linux, [[PHP]] 7.4+, [[MySQL]]-workalike, [[Apache web server|Apache]].
 +
* You'll need to have {{arg|$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.
 +
 
This page will eventually need to include a lot more information, but for now the basic setup procedure is:
 
This page will eventually need to include a lot more information, but for now the basic setup procedure is:
* Clone the [https://gitlab.com/woozalia/VbzCart/tree/ferreteria-v2/config VbzCart Git repository]<ref name=branch /> into a folder of your choice, which we'll call <code>[vbzcart base]</code>.
+
* Clone the VbzCart Git repository at <code>{{i/var/page|git.origin}}</code> into a folder of your choice, which we'll call {{arg|vbz-base}}.
* Copy the <code>[vbzcart base]/config</code> folder to a location outside of <code>[vbzcart base]</code>.
+
* Copy the <code>{{arg|vbz-base}}/config</code> folder to a location outside of <code>{{arg|vbz-base}}</code>.
** We'll call this new location <code>[local config]</code>.
+
** We'll call this new location {{arg|local-config}}.
 
** My standard location for this is <code>/home/vbz/site/config/vbzcart</code>
 
** My standard location for this is <code>/home/vbz/site/config/vbzcart</code>
* Copy the <code>[local config]/examples</code> folder to <code>[local config]/local</code>
+
* Rename the <code>{{arg|local-config}}/examples</code> folder to <code>{{arg|local-config}}/local</code>.
 
* Modify each file to match your local environment, according to instructions in each file.
 
* Modify each file to match your local environment, according to instructions in each file.
* Optional: modify files in <code>[local config]/portable</code> as needed.
+
* Optional: modify files in <code>{{arg|local-config}}/portable</code> as needed.
* [[Ferreteria/install|Install Ferreteria]]
+
* {{l/ferreteria/|install|Install Ferreteria}}
 
* Set up database and tables (instructions to be written)
 
* Set up database and tables (instructions to be written)
==Footnotes==
+
* Link or copy the <code>{{arg|local-config}}/portable/index.php</code> file to your public web folder.
<references>
+
* Link or copy the <code>{{arg|vbz-base}}/static</code> folder to your public web folder.
<ref name=branch>We're currently using the <code>ferreteria-v2</code> branch; this should probably become the master branch, once I figure out how.</ref>
+
* Create the public web ufiles folder
</references>
+
 
 +
For the canonical setup at vbz.net, see {{l/wooz|VbzCart/setup|wooz.dev}}.

Latest revision as of 16:39, 14 October 2022

Preparation

  • Prerequisites: Linux, PHP 7.4+, MySQL-workalike, Apache.
  • 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.

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

For the canonical setup at vbz.net, see VbzCart/setup.