AME 2.5x


=======================================================
Whats New in 2.5 over previous versions?
=======================================================

New in 2.5:
	- I removed all default definitions apart from youtube and amazon as they are constantly changing anyway. Check vB.org for the latest user made definitions
	- Ability to have validation rules to prevent embedding a video that doesnt allow embedding (requires extraction setting to be on)
	- Ability to prevent non authorised usergroups from viewing (see limitations below)
	- Usergroup permissions (edit usergroup to adjust edit/view permissions)
	- Template driven system - uses templates now instead of 1 master replacement (see limitations below)
	- Signatures supported
	- Different sizes and template configurations for each supported zone (posts, blogs, groups, visitor messages and signatures)
	- A couple new hooks
	- Notfication system (similar to vB's to check for errors)
	- definition keys for easier updating of definitions and to use in templates
	- File caching system which radically reduces processing
	- And more that I cant think of off the top of my head!



=======================================================
New Installations
=======================================================

1. I am assuming that you have downloaded the package and have unzipped it (hence you are reading this)
2. Upload ALL of the files and folders found in the zip packages 'forums' folder into your forums root folder. Most folders will correspond with your vB folders however: If you have changed the folder name of your admincp folder, upload the contents of upload/forums/admincp into your forums/RENAMEDadmincp folder. You may also want to upload the images in the images/misc folder into your styles image folder.
3. Import the product-ame.xml file into your vBulletin product manager

=======================================================
To Upgrade
=======================================================

1. Upload the contents of the upload/forums folder into your root folder (overwriting previous versions of the files)
2. Reimport the product-ame.xml file into your vBulletin product manager (choosing to overwrite previous installation)
3. If you are using the file cache, it is strongly recommended that you resave your cache using the tools menu


=======================================================
Important things to note
=======================================================

Limitations with usergroup viewing permissions
----------------------------------------------
The new system uses javascript to attempt to 'hide' the embedded media and 'show' a default URL. If the user doesnt have javascript enabled or places an embedded video in their post, it will appear to them until they refresh the page. Of course, if the person doesnt have permission to view, I doubt they would have permission to embed anyway!

Another limitation with permissions will be that if someone with permission to post urls edits someones who doesnt... well.. . it will appear!



Limitations with templates
-----------------------------------------------
vBulletin caches the contents of posts. This means that if you put a condition into one of AMEs templates that will somehow alter the contents based on who is viewing it... you will get unexpected results. Say for example, in AMEs template you used the following conditional:

<if condition="$bbuserinfo['userid']==1">Hi Administrator!</if>

If someone other than userid #1 created the post (and hence the cache), it won't appear, even when user #1 views it! Obviously the opposite is also true.
The only way to get around this is to turn off vBulletins postcache, but I wouldn't reccomend it!



Changes to definitions
-----------------------------------------------
Changes to definition replacements are as follows:
	- Stop using width and height tags in your object and embed tags. Instead, use $ameinfo[height] and $ameinfo[width] respectively. This is so that users can specify the dimensions in their settings and use the same definition in different areas of the site.
	- start putting the ameid tag in your exported items. This is a unique identifier (similar to vB's productid) that can contain only alphanumeric characters and an underscroe (basically any combination of letters, numbers and the _ character. No spaces permitted). This tag will help prevent duplicate imports and also give the template the option of knowing what type of media it is.



What is left to do
----------------------------------------------
Sleep