prepare for open source server release

.gitignore

@@ -5,3 +5,4 @@ include/jquery-1.4.2.min.js
 *.log
 *.out
 push
+home.html

INSTALL

@@ -1,38 +1,76 @@
-Installation guide
 
-The following notes apply to alpha/beta releases. Some manual installation is 
-required at this time. 
+Mistpark Installation
 
+This is an early release. Some manual installation is required at this time. 
 
 1. Requirements
 	- Apache with mod-rewrite enabled and "Options All" so you can use a 
 local .htaccess file
+
 	- PHP > 5.1. The later the better. You'll need 5.3 for full openssl 
 encryption support
+
 	- PHP *command line* access with register_argc_argv set to true in the 
 php.ini file
+
 	- Mysql 5.x
-	- cron
+
+	- ability to schedule jobs with cron (Linux/Mac) or Scheduled Tasks
+(Windows)
 	
 	[Dreamhost.com offers all of the necessary hosting features at a 
 reasonable price. If your hosting provider doesn't allow Unix shell access, 
 you might have trouble getting everything to work.] 
 
-2. Edit htconfig.php and change system settings. Rename to .htconfig.php
+2. Put this directory into the root of your web server document area.
 
-3. Import database.sql into your database with mysql command line or via phpmyadmin
+	- If you copy the directory tree to your webserver, make sure
+	that you also copy .htaccess - as "dot" files are often hidden 
+	and aren't normally copied.
 
-4. Import updates.sql (if it exists) to catch any late-breaking devel changes
-
-5. Put this directory into the root of your web server document area.
-	- To use a subdir of your main site, set the 
+	- To use a subdirectory of your main domain, set the 
 	config variable $a->path to the relative subdir
 	in .htconfig.php - for example to use http://example.com/test - 
-	set $a->path to 'test'.
+	use
+		$a->path = 'test';
+
+	In this case, you cannot use the web installer. 
+	Skip step 3 and proceed to step 4 - especially steps 4a and 4b.
+
 	- Everything will work much better if you can dedicate a domain 
 	or subdomain so that you don't require an extra server path. 
 
-6. Navigate to your site with a web browser and register an account.
+3. Visit your website with a web browser and follow the instructions. 
 
-7. Set up a cron task to run "php include/poller.php http://my.domain.name" once every 5-10 minutes. 
+4. *If* the automated installation fails for any reason, check the following:
 
+	4a. ".htconfig.php" exists 
+		If not, edit htconfig.php and change system settings. Rename 
+to .htconfig.php
+	4b. Database is populated.
+		If not, import the contents of "database.sql" with phpmyadmin 
+or mysql command line
+
+5. At this point visit your website again, and register your personal account. 
+Registration errors should all be recoverable automatically. 
+If you get any *critical* failure at this point, it generally indicates the
+database was not installed correctly. You might wish to move/rename 
+.htconfig.php to another name and empty (called 'dropping') the database 
+tables, so that you can start fresh.  
+
+6. Set up a cron job or scheduled task to run the poller once every 5-10 
+minutes to pick up the recent "public" postings of your friends. Example:
+
+	cd /base/directory; /path/to/php include/poller.php
+
+Change "/base/directory", and "/path/to/php" as appropriate for your situation.
+
+If you are using a Linux server, run "crontab -e" and add a line like the 
+one shown, substituting for your unique paths and settings:
+
+*/5 * * * *	cd /home/myname/mywebsite; /usr/bin/php include/poller.php
+
+You can generally find the location of PHP by executing "which php". If you 
+have troubles with this section please contact your hosting provider for 
+assistance. Mistpark will not work correctly if you cannot perform this step.
+  

LICENSE

@@ -0,0 +1,25 @@
+* Mistpark
+* Copyright (c) 2010, Mike Macgirvin
+* All rights reserved.
+*
+* Redistribution and use in source and binary forms, with or without
+* modification, are permitted provided that the following conditions are met:
+*     * Redistributions of source code must retain the above copyright
+*       notice, this list of conditions and the following disclaimer.
+*     * Redistributions in binary form must reproduce the above copyright
+*       notice, this list of conditions and the following disclaimer in the
+*       documentation and/or other materials provided with the distribution.
+*     * Neither the name of Mistpark nor the
+*       names of its contributors may be used to endorse or promote products
+*       derived from this software without specific prior written permission.
+*
+* THIS SOFTWARE IS PROVIDED BY Mike Macgirvin ``AS IS'' AND ANY
+* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+* DISCLAIMED. IN NO EVENT SHALL Mike Macgirvin BE LIABLE FOR ANY
+* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README

@@ -0,0 +1,30 @@
+
+Mistpark Server
+Version 2.0 alpha
+
+IMPORTANT: Please see the file INSTALL for system requirements.
+
+Mistpark introduces a new generation of social networks. Mistpark Server
+allows you to interact with other members of the Mistpark community using
+the DFRN (Distributed Friends and Relations Network) protocol. Other networks
+(such as Diaspora, OneSocialWeb, status.net, etc.) will be supported in the 
+future as their products mature and protocol and privacy/rights issues are 
+resolved between these networks. 
+
+It's your network now. If social networking isn't what you thought it would 
+be, help us to make it better.  
+
+A single instance of Mistpark Server supports up to several hundred people 
+using commodity hosting hardware. Also available from Mistpark Labs is 
+Mistpark Personal Edition, which supports a single user. 
+
+Please see http://dfrn.org for more information on the mistpark/DFRN project.
+
+We will be providing a support site specifically for mistpark at 
+http://mistpark.com at a future (unspecified) date. We are still 
+evaluating wiki, forum, and bug-tracking software for use on the project. 
+At the present time, you may contact the author and raise issues via
+the source code repository on github. 
+
+Please support mistpark with a donation.  
+

mod/item.php

@@ -227,7 +227,7 @@ function item_post(&$a) {
 
 	$php_path = ((strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php');
 
-	proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"$notify_type\" \"$post_id\" > notify.out &",
+	proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"$notify_type\" \"$post_id\" &",
 		array(),$foo));
 
 	goaway($a->get_baseurl() . "/" . $_POST['return'] );
@@ -317,7 +317,7 @@ function item_content(&$a) {
 			
 			// send the notification upstream/downstream as the case may be
 
-			proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"drop\" \"$drop_id\" > drop.out &",
+			proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"drop\" \"$drop_id\" &",
 				array(), $foo));
 
 			goaway($a->get_baseurl() . '/' . $_SESSION['return_url']);

mod/like.php

@@ -97,7 +97,7 @@ function like_content(&$a) {
 
 		$php_path = ((strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php');
 
-		proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"like\" \"$post_id\" > notify.out &",
+		proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"like\" \"$post_id\" &",
 			array(),$foo));
 		return;
 	}
@@ -164,7 +164,7 @@ EOT;
 
 	$php_path = ((strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php');
 
-	proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"like\" \"$post_id\" > notify.out &",
+	proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"like\" \"$post_id\" &",
 		array(),$foo));
 
 	return; // NOTREACHED

mod/message.php

@@ -70,7 +70,7 @@ function message_post(&$a) {
 	$php_path = ((strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php');
 	
 	if($post_id) {
-		proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"mail\" \"$post_id\" > mail.out &",
+		proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"mail\" \"$post_id\" &",
 			array(),$foo));
 		notice( t('Message sent.') . EOL );
 	}