README

********
** How to set up UNL_Elgg:
********
Run the setup.sh script to symlink all the necessary plugins
	./setup.sh
Create a database named unl_social
Import the full_dump.sql file*
	mysql -u root unl_social < full_dump.sql
Browse to the elgg directory in your web browser.
Create the local elgg/.htaccess file using the sample on the install page
	Be sure to set the correct RewriteBase /~bbieber/UNL_Elgg/elgg/ for example.
Create the local elgg/engine/settings.php file.
	Be sure to specify unl_social as the database name
Create a local directory for elgg data outside of the web root.
	Change the permissions so Apache has write access to it.
	sudo chown _www elgg_data
Install the UNL_Templates pear packages
	pear channel-discover pear.unl.edu && pear install unl/UNL_Templates-beta unl/UNL_Services_Peoplefinder-beta DB
Set the correct site url within the database:
	UPDATE elggsites_entity SET url='http://localhost/workspace/UNL_Elgg/elgg/' WHERE guid=1;
	UPDATE elggdatalists SET value = '/Users/smeranda/Documents/workspace/UNL_Elgg/elgg/' WHERE name = 'path';
	UPDATE elggdatalists SET value = '/Users/smeranda/Documents/workspace/elgg_data/' WHERE name = 'dataroot';
Make sure the local site has an updated copy of the templatedependents

 

*******
** Notes on importing data:
*******
full_dump.sql is is full copy of the mysql database that must be modified upon import.
safe_dump.sql can be imported without the need for modification

when importing full_dump.sql, you must modify certain rows in the tables elggdatalists and elggsites_entity so
that they pertain to the local elgg site instance. 	(so if you see something like 
http://ucommjuhl.unl.edu/UNL_Elgg/elgg, change it!)



*******
** Changes made to the Elgg engine for UNL's implementation (changes made inside the elgg directory)
*******
-Altered /elgg/engine/lib/users.php to bar registration of accounts starting with "unl_"

	function register_user($username, $password, $name, $email, $allow_multiple_emails = false, $friend_guid = 0, $invitecode = '', $isfromSSO = false) {
	
		// Check to see if $username begins with "unl_"
			if($isfromSSO==false)
			{
				if ( "unl_" == substr($username,0,4) ) {
					//return false;
					throw new RegistrationException("Username cannot begin with 'unl_'");
				}
			}

-Changed the languages file to allow for new wording (elgg/languages/en.php:
*/OLD/*
 'friends:of' => "Friends of",
 'friends:collections' => "Collections of friends",
 'friends:collections:add' => "New friends collection",
 'friends:addfriends' => "Add friends",
 'friends:collectionname' => "Collection name",
 'friends:collectionfriends' => "Friends in collection",
 'friends:collectionedit' => "Edit this collection",
 'friends:nocollections' => "You do not yet have any collections.",
 'friends:collectiondeleted' => "Your collection has been deleted.",
 'friends:collectiondeletefailed' => "We were unable to delete the collection. Either you don't have permission, or some other problem has occurred.",
 'friends:collectionadded' => "Your collection was successfuly created",
 'friends:nocollectionname' => "You need to give your collection a name before it can be created.",
'friends:collections:members' => "Collection members",
'friends:collections:edit' => "Edit collection",


 'friends:of' => "Friends of",
 'friends:collections' => "Lists of friends",
 'friends:collections:add' => "New friend list",
 'friends:addfriends' => "Add friends",
 'friends:collectionname' => "List name",
 'friends:collectionfriends' => "Friends in list",
 'friends:collectionedit' => "Edit this list",
 'friends:nocollections' => "You do not yet have any lists.",
 'friends:collectiondeleted' => "Your list has been deleted.",
 'friends:collectiondeletefailed' => "We were unable to delete the list. Either you don't have permission, or some other problem has occurred.",
 'friends:collectionadded' => "Your list was successfuly created",
 'friends:nocollectionname' => "You need to give your list a name before it can be created.",
'friends:collections:members' => "List members",
'friends:collections:edit' => "Edit list",

*/NEW/*
*******
** Plugin info
*******
Just run the setup.sh script. If any plugins are added, add this to the setup.sh script.