View source for Setting up Elgg VM on CedeusGeoNode

>> return to [[Cedeus_IDE]]
----

== Elgg VM setup ==

# copying basicubunutu1404.vdi file and renaming to elgg.vdi
# creating the tilestream VM on CedeusDB (ip.18):
#* <code>VBoxManage createvm --name elgg --ostype Ubuntu_64 --register</code>
#* <code>VBoxManage modifyvm elgg --memory 4096</code>
#* <code>VBoxManage modifyvm elgg --cpus 4</code>
#* <code>VBoxManage modifyvm elgg --nic1 nat</code>
#* <code>VBoxManage storagectl elgg --name "SATA Controller" --add sata --controller IntelAhci</code>
#* assign the (old) disk image a new uuid
#*: <code>VBoxManage internalcommands sethduuid elgg.vdi</code>
#* attach the (old) disk image:
#*: <code> VBoxManage storageattach "elgg" --storagectl "SATA Controller" --port 0 --device 0 --type hdd --medium elgg.vdi</code>
#* <code> VBoxManage storagectl elgg --name "IDE Controller" --add ide --controller PIIX4</code>
#* set the nat rules (ports):
#*: <code> VBoxManage modifyvm elgg --natpf1 "ssh,tcp,,15022,,22"</code>
#*: <code> VBoxManage modifyvm elgg --natpf1 "apache,tcp,,15080,,80"</code>
# optional - set VRDE port:
#* <code>VBoxManage modifyvm elgg --vrdeport 7765</code> (Note: 3389 is the default port anyway)
# start the VM
#: <code>VBoxHeadless -s elgg --vrde on &</code> 
#: the VM will listen on port 7765
# The following step do not seem to be necessary with Ubuntu 14.04 and new VirtualBox - however, are necesary for 12.04. But if so: connect with VRD and adjust network card settings (remember the existing VM have an old password)
#* open ''/etc/udev/rules.d/70-persistent-net.rules'' and comment out existing network adapters
#* reboot
#* check if ssh connection works
# change the computers name in ''/etc/hosts'' and ''/etc/hostname''
# restarting Apache gives the error message: "apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.1 ..."
:: => solve this by adding ''ServerName elgg'' as the last line in ''/etc/apache2/apache2.conf'' file

== Elgg Setup ==

General Docs: http://learn.elgg.org/en/latest/

Install docs: 
* http://learn.elgg.org/en/latest/intro/install.html and http://learn.elgg.org/en/latest/intro/install.html#ubuntu-linux
* https://www.digitalocean.com/community/tutorials/how-to-install-and-setup-elgg-on-a-debian-or-ubuntu-vps--2

* Elgg needs LAMPS (MySQL 5+, PHP 5.3.3+), so:
* check what software packages are installed on the VM with <code>dpkg -l</code>
: => looks like 14.04 comes with MySQL 5.5 and PHP 5.5
* however, I am missing php5 gd lib, so lets (re-)install the bunch of libs
: <code>sudo apt-get install php5 php5-gd php-xml-parser php5-mysql</code>
* Apache ''rewrite'' module should be enabled too
:: <code>sudo a2enmod rewrite</code>
* downnload Elgg from http://elgg.org/download.php  => I downloaded 1.8.19, the latest available and stable (= non RC) version
* unzip and place in www folder of server 
::<code>unzip elggXXX</code>
::<code>mv elggXXX elgg</code> (i.e. rename folder)
::<code>sudo cp -r elgg /var/www/html/</code> (copy folder to www/html to be accessible for Ubuntu 14.04)
* create a ''data'' folder outside of ''/www'' or ''/public_html'' and make it accessible via for elgg:
:: <code>sudo chown -R www-data:www-data /elggdata</code>
: => ''www-data'' is apache's user that writes to file system. The above command grants apache ownership of the data directory.
* create a database for elgg:
:: <code>mysql -u root -p</code> (pw 20...s)
:: <code>CREATE DATABASE elgg;</code>
:: <code>CREATE USER elgguser IDENTIFIED BY 'elggpassword';</code> -- (elggpwd: elggc...s) -- perhaps may be better to use <code>CREATE USER 'elgguser'@'localhost' IDENTIFIED BY 'elggpasswd';</code>
:: <code>GRANT ALL ON elgg.* TO elgguser;</code>
:: <code>\q</code>
* to be enable .htaccess in document root the access settings need to be changed in ''/etc/apache2/sites-available/default'' from ''AllowOverride None'' to ''AllowOverride All'' for the directory /var/www/html/ => Problem, this was for older Apache version, now in Ubuntu 14.04 we have 000-default.conf that does not contain this setting yet. So we do the following:
:: <code>sudo nano /etc/apache2/sites-available/000-default.conf</code>
:: Search for ''DocumentRoot /var/www/html'' and add the following lines directly below::
:: <code><Directory "/var/www/html"></code>
::: <code>AllowOverride All</code>
:: <code></Directory></code>
:: and do restart apache2
* move and rename files (perhaps use <code>sudo</code>)
:: <code>mv /var/www/html/elgg/htaccess_dist /var/www/html/elgg/.htaccess</code>
:: <code>mv /var/www/html/elgg/engine/settings.example.php /var/www/html/elgg/engine/settings.php</code>
* Open up the ''settings.php'' file and fill in the database access details:
:: <code>sudo nano /var/www/html/elgg/engine/settings.php</code>
:: set:
::* <code>$CONFIG->dbuser = 'elgguser';</code>
::* <code>$CONFIG->dbpass = 'elggc...s';</code>
::* <code>$CONFIG->dbname = 'elgg';</code>
::* <code>$CONFIG->dbhost = 'localhost';</code>
::* <code>$CONFIG->dbprefix = '';</code>
* navigate to http://146.155.17.19:15080/elgg/install.php to perform the setup
* some settings I did:
** registration open/public accessible
** name Cedeus - miCiudad
** login ssteinig (2..s) : registered email is uzh (2nd user: ment...r : s...o4...)
** outgoing email fuer elgg(!): ssteiniger-uc (not shure if this works, though)

== Settings after Elgg installation ==

Elgg 1.8.19 ist installed/accessible now via http://146.155.17.19:15080/elgg/
(the test version with Elgg 1.8.3: if the VM is running http://146.155.17.19:31080/elgg/)

* in Administration > Settings > Advanced Settings
** set "default access permissions" to "friends"
** uncheck "Allow new users to register"
* Plugins:
** activated Embed 1.8
** activated Diagnostics 1.8
** download and install : Spanish Formal Core language pack for Elgg 1.8 : http://community.elgg.org/plugins/1479860/1.0/spanish-formal-core-language-pack
*: Note, the user can define his language. So, the admin pages can be English while new user will have Spanish as default.
** download and install : Friend request for Elgg 1.8 : http://community.elgg.org/plugins/384965/3.3/friend-request
** download and install: Honeypot Spam Catcher for Elgg 1.8 : http://community.elgg.org/plugins/1131529/1.0/honeypot-spam-catcher
** todo check: User validation by admin for 1.8.X for Elgg 1.8 : http://community.elgg.org/plugins/875414/1.1/user-validation-by-admin-for-18x
** todo check: Member Selfdelete 1.8.x for Elgg 1.8 : http://community.elgg.org/plugins/860132/1.1/member-selfdelete-18x
** todo check: Elgg Captcha for Elgg 1.8 : http://community.elgg.org/plugins/1172111/1.8.15C/elgg-captcha
** todo check: Spam Checker for Elgg 1.8/1.9 : http://community.elgg.org/plugins/1650435/1.9/spam-checker
** todo check: Speak Freely Plugin

== Some notes on programming with Elgg ==
* dev environment: IDE PhpStorm
*: Note, I have setup the programming environment so, that the elgg plugin's project/files are directly modified in ''/var/www/html/elgg/mod/...''
* disable caching (in admin settings) and enable display of php errors
* documentation : see in the elgg install folders: ''.../elgg/documentation/''
* we also have the Elgg book by C Costello and M. Sharma : http://www.packtpub.com/web-development/elgg-18-social-networking 
* (plugin) examples can be found in ''.../elgg/documentation/examples/ + .../plugins'' in particular for ''start.php'' and ''manifest.xml'' files that have to be in a plugins root folder

== Notes on PYP Theming Plugin ==
* it looks like this was done overly complicated. After reading the book chapters with examples (chapter 7,8,9), it seems like a re-write is in order to using page one-column layout instead, e.g.: <code>elgg_view_layout('one_column', $vars);</code>
* ToDos:
** (perhaps) create new PypTheming plugin with
*** PYP Welcome Page
*** PYP color style and fonts
*** PYP logo
** create Cedeus/MiCiudad Elgg style
*** white background
*** cedeus font + text  color (CSS)
*** Cedeus logo
*** Cedeus welcome page

== Notes on MapComment/ Plugin ==
* there is no extra DB needed. Its all written to the default DB.
* the category page doesn't show a map after setup, as the like and dislike groups required. 
*: => after creation of an item/mapComment for each group, a map is shown
*: see also the php warning: ''"Invalid argument supplied for  foreach()" in file /var/www/html/elgg/modpypMapComment/pages/category.php (line 14)'' that seems to be resolved when initial items are added
* switching to the index page (i.e. vy clicking on "Add new comment...") shows everything that is needed (no changes here?)
* '''ToDos''': 
** set to OSM and/or create custom tile map for south of chile
** translate to Spanish
** check - there seems to be an offset for locations (marker was placed a few blocks towards south, i.e. 1.5-2 times the dot-icon size, for a zoom level)
**: => note, when zooming in and out, while addind the item, the dot's position (not yet fixed) changes strongly in north-south direction :(
** perhaps remove header part (that allows search for an address and placing a comment) - as it seems a bit confusing to me 
** add option to upload fotos
** correct map focus on "issue" selection
** adjust comment privacy level I am not able to see the map/comments when I am logged out (this may be a general setting issue?) => yes, mapcomments are private if the general user created comments are set to private. (friends can see friends comments). So the general elgg setting of "privacy" needs to be "public" to see coments without being logged in.
** give user a feedback that new comment is added