Recent changes to home

home modified by Giovanni Lo Magno

Giovanni Lo Magno — Fri, 11 Nov 2016 19:40:05 -0000

--- v30
+++ v31
@@ -169,20 +169,20 @@

 -----
 # Also see
-[2016 Italian Stata Users Group Meeting, Rome 17-18 November](http://www.stata.com/meeting/italy16/)
-*Abstract and slides that were presented at the Italian Stata Users Group Meeting Meeting 2016*
-
 [SWire](https://sourceforge.net/p/swire/documentation/home/edit)
 *A software interface, enabling us to query Stata for the executing of basic operations, such as reading or writing data*

+[2016 Italian Stata Users Group Meeting, Rome 17-18 November](http://www.stata.com/meeting/italy16/)
+*Abstract and slides presented at the Italian Stata Users Group Meeting 2016*
+
 [SWire Web Apps Collection](https://sourceforge.net/projects/swire-web-apps-collection/)
-*A collection of web apps interacting with Stata through SWire*
+*A collection of web apps, interacting with Stata through SWire*

 [SWire4js](https://sourceforge.net/projects/swire4js/)
 *A JavaScript library for developing SWire web applications*

 [SWire4R](https://sourceforge.net/projects/swire4r/)
-*An R package enabling R to interact with Stata for data exchange*
+*An R package enabling R to interact with Stata for exchanging data*

 [Swire4QGIS](https://sourceforge.net/projects/swire4qgis/)
-*A QGIS plugin enabling data exhange with Stata*
+*A QGIS plugin enabling data exchange with Stata*

home modified by Giovanni Lo Magno

Giovanni Lo Magno — Fri, 11 Nov 2016 14:44:43 -0000

--- v29
+++ v30
@@ -3,7 +3,7 @@

 -----
 # Introduction
-SQuery is a web application for creating and completing questionnaires, and collate the resulting data in [Stata](http://www.stata.com/). SQuery uses [SWire](https://sourceforge.net/projects/swire/) for communicating with Stata. SQuery has been developep for running on a local network.
+SQuery is a web application for creating and completing questionnaires, and collate the resulting data in [Stata](http://www.stata.com/). SQuery uses [SWire](https://sourceforge.net/projects/swire/) for communicating with Stata. SQuery has been developed for running on a local network.

 [[img src="squery_and_stata.png" alt="SQuery and Stata" width="400"]]

home modified by Giovanni Lo Magno

Giovanni Lo Magno — Fri, 11 Nov 2016 14:41:25 -0000

--- v28
+++ v29
@@ -5,7 +5,7 @@
 # Introduction
 SQuery is a web application for creating and completing questionnaires, and collate the resulting data in [Stata](http://www.stata.com/). SQuery uses [SWire](https://sourceforge.net/projects/swire/) for communicating with Stata. SQuery has been developep for running on a local network.

-[[img src="squery_and_stata.png" alt="SQuery and Stata"]]
+[[img src="squery_and_stata.png" alt="SQuery and Stata" width="400"]]

 This is what SQuery can do:

home modified by Giovanni Lo Magno

Giovanni Lo Magno — Fri, 11 Nov 2016 14:40:12 -0000

--- v27
+++ v28
@@ -4,6 +4,15 @@
 -----
 # Introduction
 SQuery is a web application for creating and completing questionnaires, and collate the resulting data in [Stata](http://www.stata.com/). SQuery uses [SWire](https://sourceforge.net/projects/swire/) for communicating with Stata. SQuery has been developep for running on a local network.
+
+[[img src="squery_and_stata.png" alt="SQuery and Stata"]]
+
+This is what SQuery can do:
+
+* it can create questionnaires and publish them on a local network
+* it can collect responses from mobile devices
+* users can complete the questionnaire from their web browser
+* data are directly stored in Stata.

 -----
 # Requirements

home modified by Giovanni Lo Magno

Giovanni Lo Magno — Fri, 11 Nov 2016 14:33:51 -0000

--- v26
+++ v27
@@ -66,13 +66,13 @@

 Check that the following folders and their sub-folders can be written in by your web server (note: in Ubuntu the web server user is *www-data*):

-* var/cache
-* var/logs
-* var/sessions
+* *var/cache*
+* *var/logs*
+* *var/sessions*

 For more information about how to set up the correct file permissions for the previous folders in a Symfony application, visit http://symfony.com/doc/current/setup/file_permissions.html.

-The folder to be served by your web server is *web*. Thus, if  SQuery had been  installed in */home/john/squey0.1beta*, then the web folder would be */home/john/squery_0.1_beta/web*. Inform the web server that this is the folder to serve. For Apache you can use the *squery.conf* file, which is in the *squery_0.1_beta* folder, as your active Apache configuration file. Edit this file by inserting the right folder names and then copy the file to the folder where Apache "expects" to find it (in Ubuntu this folder is */etc/apache2/sites-enabled*). A possible configuration file could be:
+The folder to be served by your web server is *web*. Thus, if  SQuery had been  installed in */home/john/squeRy_0.1_beta*, then the web folder would be */home/john/squery_0.1_beta/web*. Inform the web server that this is the folder to serve. For Apache you can use the *squery.conf* file, which is in the *squery_0.1_beta* folder, as your active Apache configuration file. Edit this file by inserting the right folder names and then copy the file to the folder where Apache "expects" to find it (in Ubuntu this folder is */etc/apache2/sites-enabled*). A possible configuration file could be:

 ```
 :::apache
@@ -98,7 +98,7 @@

 If the web server is running correctly, you can open the http://127.0.0.1/config.php page. This page will analyze the system to check whether is ready to run Symfony applications. Check now that all requirements have been met.

-Finally, start using SQuery at this address: http://127.0.0.1/app.php. Note that the app.php file is the entry-point of the entire SQuery application. If you wish to enable your users to access SQuery by only typing the host address from their web browser (for example, http://192.168.0.101 instead of  http://192.168.0.101/app.php), the → module in Apache2 must be enabled. To do this, type the following in the Ubuntu terminal:
+Finally, start using SQuery at this address: http://127.0.0.1/app.php. Note that the *app.php* file is the entry-point of the entire SQuery application. If you wish to enable your users to access SQuery by only typing the host address from their web browser (for example, http://192.168.0.101 instead of  http://192.168.0.101/app.php), the *mod_rewrite* module must be enabled in Apache2. To do this, type the following in the Ubuntu terminal:

 ```
 :::bash
@@ -142,7 +142,7 @@
 * the active questionnaire, namely the questionnaire which logged-in users can complete
 * the active group, namely the group which is enabled to complete the questionnaire.

-Before allowing the users to fill in the active questionnaire, the corresponding Stata dataset must be created. This dataset will the following set of variables:
+Before allowing the users to fill in the active questionnaire, the corresponding Stata dataset must be created. This dataset will have the following set of variables:

 * *username*: the username
 * *password*: the encrypted password
@@ -156,7 +156,7 @@

 [[img src="stata_dataset_before.png" width="700" alt="Stata dataset before users fill in their questionnaires"]]

-SWire will use the username and password data to detect the correct dataset row to update with data from the user.
+SWire will use the *username* and *password* data to detect the correct dataset row to update with data from the user.

 -----
 # Also see

home modified by Giovanni Lo Magno

Giovanni Lo Magno — Fri, 11 Nov 2016 14:29:25 -0000

--- v25
+++ v26
@@ -72,7 +72,7 @@

 For more information about how to set up the correct file permissions for the previous folders in a Symfony application, visit http://symfony.com/doc/current/setup/file_permissions.html.

-The folder to be served by your web server is *web*. Thus, if  SQuery had been  installed in */home/john/squey0.1beta*, then the web folder would be */home/john/squey0.1beta/web*. Inform the web server that this is the folder to serve. For Apache you can use the *squery.conf* file, which is in the *squey0.1beta folder*, as your active Apache configuration file. Edit this file by inserting the right folder names and then copy the file to the folder where Apache "expects" to find it (in Ubuntu this folder is */etc/apache2/sites-enabled*). A possible configuration file could be:
+The folder to be served by your web server is *web*. Thus, if  SQuery had been  installed in */home/john/squey0.1beta*, then the web folder would be */home/john/squery_0.1_beta/web*. Inform the web server that this is the folder to serve. For Apache you can use the *squery.conf* file, which is in the *squery_0.1_beta* folder, as your active Apache configuration file. Edit this file by inserting the right folder names and then copy the file to the folder where Apache "expects" to find it (in Ubuntu this folder is */etc/apache2/sites-enabled*). A possible configuration file could be:

 ```
 :::apache

home modified by Giovanni Lo Magno

Giovanni Lo Magno — Fri, 11 Nov 2016 14:27:37 -0000

--- v24
+++ v25
@@ -32,7 +32,7 @@
 composer install --optimize-autoloader
 ```

-During the execution of the previous command, Composer will request the inputting of various settings. In this phase, it is very important to correctly set: the database host, the database port, the database name, the database username and the database password. A possible database name could be squery_0_1. E-mail configuration is not required, thus the default values can be left unchanged. Finally, type a long random string to obtain the secret token. When Composer has terminated, check for possible reported errors and correct them prior to continuing the installation. All these settings can be changed later by editing the *parameters.yml* file in the *squery_0.1_beta* folder (*parameters.yml* is written by using the [YAML](http://yaml.org/) syntax).
+During the execution of the previous command, Composer will request the inputting of various settings. In this phase, it is very important to correctly set: the database host, the database port, the database name, the database username and the database password. A possible database name could be *squery_0.1*. E-mail configuration is not required, thus the default values can be left unchanged. Finally, type a long random string to as the secret token. When Composer has terminated, check for possible reported errors and correct them prior to continuing the installation. All these settings can be changed later by editing the *parameters.yml* file in the *squery_0.1_beta* folder (*parameters.yml* is written by using the [YAML](http://yaml.org/) syntax).

 If everything is ok with Composer, you can tell Symfony to create the database, which is required by SQuery: type the following Symfony console command:

home modified by Giovanni Lo Magno

Giovanni Lo Magno — Fri, 11 Nov 2016 14:25:48 -0000

--- v23
+++ v24
@@ -25,14 +25,14 @@

 SQuery requires a web server and a database: the former is needed to distribute the SQuery web pages throughout local the network and the latter is necessary for storing all the data managed by SQuery (users, groups, questionnaires and settings). The suggested web server is [Apache HTTP Server](https://httpd.apache.org/), while the suggested database is [MySQL](https://www.mysql.it/). Other databases supported by Symfony 3.1 can be used but only MySQL has been tested. The web server and the database must be running prior to installing SQuery.

-The first step for installing SQuery is to download the *squery0.1beta.zip* file. Uncompress this file and enter the resulting *squery0.1beta* folder. From this folder, launch Composer to install all the PHP libraries required by SQuery (an internet connection is required):
+The first step for installing SQuery is to download the *squery_0.1_beta.zip* file. Uncompress this file and enter the resulting *squery_0.1_beta* folder. From this folder, launch Composer to install all the PHP libraries required by SQuery (an internet connection is required):

 ```
 :::bash
 composer install --optimize-autoloader
 ```

-During the execution of the previous command, Composer will request the inputting of various settings. In this phase, it is very important to correctly set: the database host, the database port, the database name, the database username and the database password. A possible database name could be squery_0_1. E-mail configuration is not required, thus the default values can be left unchanged. Finally, type a long random string to obtain the secret token. When Composer has terminated, check for possible reported errors and correct them prior to continuing the installation. All these settings can be changed later by editing the *parameters.yml* file in the *squery0.1beta folder* (*parameters.yml* is written by using the [YAML](http://yaml.org/) syntax).
+During the execution of the previous command, Composer will request the inputting of various settings. In this phase, it is very important to correctly set: the database host, the database port, the database name, the database username and the database password. A possible database name could be squery_0_1. E-mail configuration is not required, thus the default values can be left unchanged. Finally, type a long random string to obtain the secret token. When Composer has terminated, check for possible reported errors and correct them prior to continuing the installation. All these settings can be changed later by editing the *parameters.yml* file in the *squery_0.1_beta* folder (*parameters.yml* is written by using the [YAML](http://yaml.org/) syntax).

 If everything is ok with Composer, you can tell Symfony to create the database, which is required by SQuery: type the following Symfony console command:

home modified by Giovanni Lo Magno

Giovanni Lo Magno — Fri, 11 Nov 2016 14:24:17 -0000

--- v22
+++ v23
@@ -23,7 +23,7 @@

 In order to install SQuery, [Composer](https://getcomposer.org/) is required; the installation instructions for Composer are available here: https://getcomposer.org/download/

-SQuery requires a web server and a database: the former is needed to distribute the SQuery web pages throughout the network and the latter is necessary for storing all the data managed by SQuery (users, groups, questionnaires and settings). The suggested web server is [Apache HTTP Server](https://httpd.apache.org/), while the suggested database is [MySQL](https://www.mysql.it/). Other databases supported by Symfony 3.1 can be used but only MySQL has been tested. The web server and the database must be running prior to installing SQuery.
+SQuery requires a web server and a database: the former is needed to distribute the SQuery web pages throughout local the network and the latter is necessary for storing all the data managed by SQuery (users, groups, questionnaires and settings). The suggested web server is [Apache HTTP Server](https://httpd.apache.org/), while the suggested database is [MySQL](https://www.mysql.it/). Other databases supported by Symfony 3.1 can be used but only MySQL has been tested. The web server and the database must be running prior to installing SQuery.

 The first step for installing SQuery is to download the *squery0.1beta.zip* file. Uncompress this file and enter the resulting *squery0.1beta* folder. From this folder, launch Composer to install all the PHP libraries required by SQuery (an internet connection is required):

home modified by Giovanni Lo Magno

Giovanni Lo Magno — Fri, 11 Nov 2016 14:23:11 -0000

--- v21
+++ v22
@@ -19,7 +19,7 @@

 -----
 # Installation
-SQuery is a web application which has been developed for by using the [Symfony](http://symfony.com/) PHP framework (version 3.1); thus all the requirements for a normal Symfony application are also required for SQuery. These requirements are described at  http://symfony.com/doc/current/reference/requirements.html. Careful scrutiny of the requirements is suggested, ensuring that the php.ini file (to which the requirements refer) is that used by your web server (not your PHP CLI).
+SQuery is a web application which has been developed by using the [Symfony](http://symfony.com/) PHP framework (version 3.1); thus all the requirements for a normal Symfony application are also required for SQuery. These requirements are described at  http://symfony.com/doc/current/reference/requirements.html. Careful scrutiny of the requirements is suggested, ensuring that the php.ini file (to which the requirements refer) is that used by your web server (not your PHP CLI).

 In order to install SQuery, [Composer](https://getcomposer.org/) is required; the installation instructions for Composer are available here: https://getcomposer.org/download/