=== HoweScape Unity3d WebGL ===
Contributors: pthowe
Donate Link: http://HoweScape.com
Tags:
Requires at least: 4.0.0
Tested up to: 4.7.2
Stable tag: 3.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Plugin to allow the inclusion of a Unity3d WebGL application. A short code is created which can displayed.

== Description ==

The Unity3d WebGL support creates a directory of files. 
This is not convent to load  on your WordPress web site. 
This plugin takes the "Release" directory from your game and places it 
inside the plugin. When compiling the output directory need to be "Builds_WebGL". 
This plugin can then be referenced from with a short code. 
The parameters in the short code are the game name and the width and height.

ie. [hs_unity3d_web_gl_game src="Roll-A-Ball" height=500 width=600]

To extend the support for Unity3d to version 5.5.1 an additional parameter has been added. 
This parameter allows the specification of a version. The version support is 5.5.1 or the original version supported by the plugin. (ie. original version 5.3.1)
The Unity3d version 5.5.1. creates a directory  "Development". This is what I have uploaded in the included example. (ie. Roll-A-Ball-5_5_1-Release)
The short code  is now looks like the following example.

ie. [hs_unity3d_web_gl_game src="Roll-A-Ball" height=500 width=600 u3dver=5.5.1]

All other features should work as before. There are other features being considered please let me know if you desire anything functionality.

With the addition of the settings page it is now possible to place 
the release directory in a zip file. (ie. <gamename>-Release.zip)
Once the file is uploaded the setting page for the plugin will allow extraction 
of the files into a location which the short code can locate. When naming games from version 5.5.1 you will need 
to include the version number. (ie. <gamename>-5_5_1-Release.zip) With this version place the 
files from the Development directory in the zip file.

== Installation ==

<h4>From your WordPress dashboard</h4>
<ol>
<li>Visit 'Plugins > Add New'</li>
<li>Search for 'HoweScape Unity3d WebGL'</li>
<li>Activate HoweScape Unity3d WebGL from your Plugins page. </li>
</ol>

<h4>From WordPress.org</h4>
<ol>
<li>Download HoweScape Unity3d WebGL.</li>
<li>Upload the 'HoweScape Unity3d WebGL' directory to your '/wp-content/plugins/' directory, using your favorite method (ftp, sftp, scp, etc...)</li>
<li>Activate HoweScape Unity3d WebGL from your Plugins page. </li>
</ol>

== Frequently Asked Questions ==

<ol>
<li>Can I use this plugin with my own Unity3d game?
	<p>Yes Take the release directory from Unity3d Build directory and place in the plugin directory. Prefix the release directory with the name of the game ending in "-Release" The game name then is used in the short code.</p>
</li>
<li>Can there be multiple games in the plugin?
<p>Yes. Each game is in its own &lt;gamename&gt;-Release directory</p>
<p>There are currently two games in the delivered plugin.</p></li>
<li>Can the games be placed outside the plugin?
<p>Yes, In the media directory</p>
<p>The settings page allows games to be extracted into the plugin.</p></li>
<li>How do I move the ball?
<p>The arrow keys allow movement of the ball to collect the cubes.</p></li>
<li>How to play space Shooter. 
<p>Arrow keys move ship. 
<p>Mouse button fires gun. Mouse needs to be in window.</li>
<li>My game does not work I get an error message. 
<p>"An error occured running the Unity content on this page."</p>
<p>"The error was: uncaught exception: incorrect header check"</p>
When I compiled my Unity3d game I used "Builds_WebGL" as the directory. 
This seems to be a requirement of the plugin.</li>
</ol>

== Screenshots ==

1. Screen capture of Roll-A-Ball game from unity3d.com
2. Screen capture of Roll-A-Ball game with updates to colors
3. Screen capture of Space-Shooter game from unity3d.com tutorials
4. Screen capture of error message caused by building to incorrect directory


== Changelog ==
<h4>0.3.3</h4>
<ul>
<li>Corrected expand game button.
<li>Changed configuration of upload file for a game. Zip file for a game requires a name 
matching the pattern <gameName>_5_5_1-Release.zip. 
Contents of zip file is the directory created by the Unity3d build process. There are two directorys which will
be accessed as a game. Development or Release are the supported sub directories. If both directories are available 
the Release will be selected.</li>
</ul>
<h4>0.3.1</h4>
<ul>
<li>Added support for Unity3d 5.5.1. This requires adding a parameter to the Short code.</li>
<li>This parameter is not required for Web GL games which have a .htaccess file</li>
<li>Example of parameter u3dver=5.5.1</li>
<li>At this time there is no other values which are supported.</li>
<li>The template data directory was also added to support version 5.5.1. </li>
<li></li>
</ul>

<h4>0.1.1</h4>
<ul>
<li>Added Settings page. This provides three groups of information. 
The first group is a list of the Unity3d games in the plugin. 
The second lists is of Unity3d games expanded into the plugin.
The third is a list of zip files in the media directory which the plugin recoginise as Unity3d gamems</li>
<li>The extract button takes the identified zip file and expands the game into a subdirectory.</li>
<li>Updated processing to to include search to include expanded games.</li>
</ul>

<h4>0.2</h4>
<ul>
<li>Update file Calling to use recommended</li>
<li>Removed "Created with unity" link from plugin</li>
</ul>

<h4>0.1</h4>
<ul>
<li>Original Release</li>
</ul>

== Upgrade Notice ==

Second update to add settings page and support extract of game from media zip file.

First update to correct file location references. Removed "Created with Unity" link.

Being initial release there is no notice

== Arbitrary section ==

== A brief Markdown Example ==

[hs_unity3d_web_gl_game src="Roll-A-Ball" height=500 width=600]