/***********************************/
/**	Image News Module README file **/
/***********************************/
		
--------------------
PRODUCT OWNER INFO:
--------------------
kazatzo (http://www.boonex.com/kazatzo)
Contact e-mail: l.kazatzo@yahoo.com

Feel free to contact us if you have any problems.
You can use the contant e-mail to leave us your opinion about the module as well.

--------------
PRODUCT INFO:
--------------

Version: 1.0.0
Dolphin Version Compatibility: 7.0.3 - 7.0.9
License Type: IMPORTANT: This is a commercial product made by kazatzo. It cannot be modified for other than
personal usage. The "personal usage" means the product can be installed and set up for ONE domain name ONLY. 
To be able to use this product for another domain names you have to order another copy of this product 
(license). This product cannot be redistributed for free or a fee without written permission from kazatzo. 
This notice may not be removed from the source code. Upgrade possibilities: Once purchased this product you 
will get a free access to version's upgrades.

---------------------
PRODUCT DESCRIPTION:
---------------------

Improved Articles/News module with image upload support. Administrator can publish news along with an 
image (optionally) and change the regular news layout.
Main features of the module:
- Administrator can upload an image along with news
- Edit news and select other image to upload.
- Images are cropped and resized so that all images have the same ratio.
- News can be shown in two different layouts:
	- Image is resized and shown as background (behind text)
	- Image is resized and placed next to text
	
Installation is quite easy, just like regular Boonex modules. To avoid any conflict, you're recommended to 
uninstall the existing Boonex News module (if you've already installed it). 
You also have to specify write permissions for the path where images are stored. 

You can take a look at my other modules at http://www.boonex.com/market/posts/kazatzo

---------------------
INSTALLATION MANUAL:
---------------------

Installation is quite easy and simple. Only a few steps are required as specified below:
1. Extract the .zip file to the root of your dolphin site. If extraction is successful, a new folder will be 
added to the modules folder (named kazatzo) which includes the module (imagenews).None of the files extracted 
replaces any existing boonex file. 
2. Login to the admin panel and go to Tools->Modules and install the module by selecting the 'Image News version
1.x by kazatzo'
NOTE: To avoid any conflict with Boonex News Module, you're recommended to uninstall Boonex News Module, if you've
already installed it. There won't be any error, but as long as the language keys have the same translation, there 
will be two modules with the same text.
3. In order to upload images successfully, you need to change permissions (chmod 777) to the path where image news 
are uploaded. The path is modules/kazatzo/imagenews/data/files. 
4. Installation is complete and you can access the module by navigating to Modules->Image News from the admin 
panel.

----------------
UNINSTALLATION:
----------------

1. Login to the admin panel and go to Tools->Modules and unistall the module by selecting the 'Image News version 
1.x by kazatzo'

---------------------
ADMINISTRATOR MANUAL:
---------------------

1. You can set the module settings by navigating to Modules -> News. Additional settings, in comparison to the 
regular News module, include:
	- The option to select the news layout as Specified in the Product Description section. Default value is the 
	'Image behind text' value.
	- The image to upload. If you create a new entry, you just select the image to upload. If you edit an existing
	entry, the image uploaded with the existing entry (if there is any) is shown above the 'Select photo:'
	value. If the administrator chooses another image to show for the specific entry, then the existing image is 
	deleted and the new image is uploaded.
2. The length of the news snippet is fixed to 150 characters for styling purposes with the 'Image behind text' value.
If snippet length is greater than 150 characters, text might exceed image background which results in corrupted image 
list.
3. For 'Image behind text' value if one column is shown at each page, then images are not resized to column width 
to avoid news lists with very big images. As a result, images are resized to 70% of column width in single column 
pages. 
