Difference between revisions of "How To Load Board18 Game Boxes"

From BOARD18 Project WIKI
Jump to navigation Jump to search
(Added file size note.)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
==How to load a new BOARD18 game box using Linux==
==Note about game box zip file file sizes==
Some game box zip files are quite large.  If '''Load Game Box''' returns this error message
<pre>The input zip file is too big.
</pre>
Then you or the server administrator will have to adjust the following PHP.INI parameter.
<pre>upload_max_filesize = 2M</pre>
I suggest that the max file size be at least 8M.


These instructions assume that you already have a BOARD18 web site.
==How to load new BOARD18 game boxes using the Administration - Load Game Box feature==
See [[How To Create a BOARD18 WEB Site]] if you don't yet have one.
 
These instructions assume that you are an administrator or author of a BOARD18 web site.


===Perform these steps on your local PC===
===Perform these steps on your local PC===
* Browse to the [[Download Game Boxes]] page and find the game box that you want.
* Browse to the [[Download Game Boxes]] WIKI page and find the game boxes that you want.
* Download the zip file for that game box.  
* Download the zip file for each of these game boxes.
* Using FTP or SCP, move this zip file to your web server.
 
===Perform these steps on your web browser===
* Sign on to BOARD18.
* Select '''MENU-Administration'''.
* On left panel of Administration screen, select '''Load Game Box'''.
* Now you can follow the instructions in the Game Box Upload Process section of the [[BOARD18 Author's Guide]] to do any number of uploads.
 
==How to mass load BOARD18 game boxes using Linux==
 
These instructions assume that you are an administrator of a BOARD18 web site.
 
===Perform these steps on your local PC===
* Browse to the [[Download Game Boxes]] WIKI page and find the game boxes that you want to load.
* Create an empty directory which will become the game box directory used in this procedure.
* Download the zip file for each selected game box into this directory.  
* Using FTP or SCP, move this game box directory to your web server.


===Perform these steps on your Linux web server===
===Perform these steps on your Linux web server===
* Extract the zip file into your shell root directory.
* Move the sub directory [which contains the image files] to the images sub directory of your web root directory.
* Move the .json file to the control sub directory of the utility directory.
* Change to the utility directory.
* Change to the utility directory.
* Load the control file for the game box by entering on the command line:  
* Make sure that the massLoadBoxes.php file is marked as executable.
<pre>  
* Load the selected game boxes by entering on the command line:  
php loadGameBox.php control/boxname.json
<pre>php massLoadBoxes.php directory root player password rptfile
</pre>
where boxname is name of the .json file for the new game box.
* You should see an output that looks something like this:
<pre>
Successfully created game box table row 5.
The box name is 1826.
The version is REP01.
The author is Rich Price.
The date is 2013-07-15 09:26:48.
</pre>
</pre>
'directory' must be the fully qualified name of the game box directory.<br>
'root' must be the fully qualified name of the BOARD18 root directory.<br>
'player' must be the player ID of an admin level player for this BOARD18.<br>
'password' must be the password for this admin level player.<br>
'rptfile' must be the fully qualified name of the report file to be created.<br>


==How to load a new BOARD18 game box using Windows==
Note that 'root', 'directory' and 'rptfile' must all be local to this server. <br>
'''If you have a Windows environment please modify the above Linux instructions, test them and then enter them here.'''
The 'rptfile' will be initialized and will contain the reports created by the call to loadGameBox.php made for each input  file.
 
==How to load a new BOARD18 game box using a MAC==
'''If you have a MAC environment please modify the above Linux instructions, test them and then enter them here.'''


[[Category:HowTo]]
[[Category:HowTo]]

Latest revision as of 11:42, 9 October 2018

Note about game box zip file file sizes

Some game box zip files are quite large. If Load Game Box returns this error message

The input zip file is too big.

Then you or the server administrator will have to adjust the following PHP.INI parameter.

upload_max_filesize = 2M

I suggest that the max file size be at least 8M.

How to load new BOARD18 game boxes using the Administration - Load Game Box feature

These instructions assume that you are an administrator or author of a BOARD18 web site.

Perform these steps on your local PC

  • Browse to the Download Game Boxes WIKI page and find the game boxes that you want.
  • Download the zip file for each of these game boxes.

Perform these steps on your web browser

  • Sign on to BOARD18.
  • Select MENU-Administration.
  • On left panel of Administration screen, select Load Game Box.
  • Now you can follow the instructions in the Game Box Upload Process section of the BOARD18 Author's Guide to do any number of uploads.

How to mass load BOARD18 game boxes using Linux

These instructions assume that you are an administrator of a BOARD18 web site.

Perform these steps on your local PC

  • Browse to the Download Game Boxes WIKI page and find the game boxes that you want to load.
  • Create an empty directory which will become the game box directory used in this procedure.
  • Download the zip file for each selected game box into this directory.
  • Using FTP or SCP, move this game box directory to your web server.

Perform these steps on your Linux web server

  • Change to the utility directory.
  • Make sure that the massLoadBoxes.php file is marked as executable.
  • Load the selected game boxes by entering on the command line:
php massLoadBoxes.php directory root player password rptfile

'directory' must be the fully qualified name of the game box directory.
'root' must be the fully qualified name of the BOARD18 root directory.
'player' must be the player ID of an admin level player for this BOARD18.
'password' must be the password for this admin level player.
'rptfile' must be the fully qualified name of the report file to be created.

Note that 'root', 'directory' and 'rptfile' must all be local to this server.
The 'rptfile' will be initialized and will contain the reports created by the call to loadGameBox.php made for each input file.