MOODLE CONTACTS BLOCK v0.3 - Copyright (C) 2008

Design & Coding:  Dale Davies (Liverpool Community College)
Email:  dale.davies@liv-coll.ac.uk

---------------------------------------------------------------------------

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA

---------------------------------------------------------------------------



About
-----

This block was designed to add some "social networking" functionality to the
My Moodle page.

I wanted a way for users to add and remove "friends" on their My Moodle page
in much the same way as social networking sites like MySpace and Facebook.

The Contacts plugin does this in a simple way by utilising the
message_print_contacts() function within Moodle.  It is not a complicated
plugin, but used with some of the other block plugins i can now create a
My Moodle page with basic similarity to some social networking sites.




Installation
------------

1) Drop the "contacts" folder into your blocks folder.
2) Log in to Moodle and navigate to the "Notifications" admin page.
3) You can now add the block to any page.
4) You may wish to edit the global configuration for this block.




Configuration
-------------

There are two global configuration options for this block, these will
override all instances throughout your site

1) You can enter a custom title.
2) You can remove all default styling, should you wish to use your own
CSS (see below).




CSS Styling
-----------

This block has a default internal stylesheet that adds some basic styling to
the block (mainly hiding some unwanted elements from the contacts list and
tidying up the layout).  However you can use your own stylesheet if you wish.

If you have problems getting your own stylesheet to work, simply edit the global
config options for this block...  Tick the option to use your own CSS  styles.

The default CSS this block embeds on the page is as follows, you can use this
as an example for your own stylesheet...



	/* Contacts Block - Default Styles */

	.block_contacts .note, .link .remove, .link .history {
		display:none;
	}
	.block_contacts #message_contacts {
		margin:0 0 0 10px;
	}
	.block_contacts .content #message_contacts .heading{
		font-weight:bold;
		padding:10px 0 5px 0;
	}
	.block_contacts .content #add_contacts {
		margin-top:-10px;
		text-align:center;
		padding:7px 0 2px 0;
		font-size:13px;
	}





Change Log
----------

v0.1 - First version:  No configuration options!

v.02 - Added config option to remove internal CSS.
v.02 - Added str_replace() to remove empty table rows, improves
       layout of contacts list in the block.

v0.3 - Restyled global configuration page.
v0.3 - Added config option to change block title. 




---------------------------------------------------------------------------

See LICENSE.txt (file) for details of the GNU General Public License.