Как обновить uddeIM

HOW TO UPGRADE FROM UDDEIM 1.7-2.1 TO UDDEIM 2.2

How to upgrade:

---

1. a) Backup your uddeIM template (if you do not use uddeIM's default templates)

b) Backup your database (at least all tables prefixed "uddeim", when using phpMyAdmin you can
copy the tables given the copy a new name, e.g. jos_uddeim_backup).


2. Backup your configuration using the internal backup function and/or backup the config file:

/administrator/components/com_uddeim/config.class.php

I recommend to uninstall the previous version of uddeIM and then upgrade to the new version
using the component installer, so you might need this file to restore your settings.

When you are an experienced user you can also overwrite the existing files with the new
files from the archive. Please check Appendix A for the correct folder structure
(please check if there are new files which have to be uploaded).


3. Update your database tables (go to phpMyAdmin and enter following SQL statements in the SQL box,
this will create the missing fields).

You will find a small tutorial in the FAQ (chapter 1.3.x "How can I upgrade uddeIM’s tables?").


When you upgrade 2.1 to 2.2:
============================
nothing to do


When you upgrade 2.0 to 2.2:
============================
ALTER TABLE `jos_uddeim` ADD `systemflag` INT( 1 ) NOT NULL DEFAULT '0' ;
ALTER TABLE `jos_uddeim` ADD INDEX ( `systemflag` ) ;
UPDATE `jos_uddeim` SET `systemflag` = 1 WHERE `systemmessage` != '' OR `systemmessage` IS NOT NULL ;
UPDATE `jos_uddeim` SET `systemflag` = 2 WHERE `fromid` = `toid` ;


When you upgrade 1.9 to 2.2:
============================
ALTER TABLE `jos_uddeim` ADD `systemflag` INT( 1 ) NOT NULL DEFAULT '0' ;
ALTER TABLE `jos_uddeim` ADD INDEX ( `systemflag` ) ;
UPDATE `jos_uddeim` SET `systemflag` = 1 WHERE `systemmessage` != '' OR `systemmessage` IS NOT NULL ;
UPDATE `jos_uddeim` SET `systemflag` = 2 WHERE `fromid` = `toid` ;


When you upgrade 1.8 to 2.2:
============================
CREATE TABLE IF NOT EXISTS `jos_uddeim_attachments` (
`id` int(10) unsigned NOT NULL auto_increment,
`mid` int(1) NOT NULL default '0',
`tempname` TEXT NOT NULL,
`filename` TEXT NOT NULL,
`fileid` varchar(32) NOT NULL,
`size` int(1) NOT NULL default '0',
`datum` int(11) default NULL,
PRIMARY KEY (`id`),
KEY `mid` (`mid`),
KEY `fileid` (`fileid`),
KEY `datum` (`datum`)
) ENGINE=MyISAM;

ALTER TABLE `jos_uddeim` ADD `systemflag` INT( 1 ) NOT NULL DEFAULT '0' ;
ALTER TABLE `jos_uddeim` ADD INDEX ( `systemflag` ) ;
UPDATE `jos_uddeim` SET `systemflag` = 1 WHERE `systemmessage` != '' OR `systemmessage` IS NOT NULL ;
UPDATE `jos_uddeim` SET `systemflag` = 2 WHERE `fromid` = `toid` ;


When you upgrade 1.7 to 2.2:
============================
CREATE TABLE IF NOT EXISTS `jos_uddeim_attachments` (
`id` int(10) unsigned NOT NULL auto_increment,
`mid` int(1) NOT NULL default '0',
`tempname` TEXT NOT NULL,
`filename` TEXT NOT NULL,
`fileid` varchar(32) NOT NULL,
`size` int(1) NOT NULL default '0',
`datum` int(11) default NULL,
PRIMARY KEY (`id`),
KEY `mid` (`mid`),
KEY `fileid` (`fileid`),
KEY `datum` (`datum`)
) ENGINE=MyISAM;

ALTER TABLE `jos_uddeim` ADD `systemflag` INT( 1 ) NOT NULL DEFAULT '0' ;
ALTER TABLE `jos_uddeim` ADD INDEX ( `systemflag` ) ;
UPDATE `jos_uddeim` SET `systemflag` = 1 WHERE `systemmessage` != '' OR `systemmessage` IS NOT NULL ;
UPDATE `jos_uddeim` SET `systemflag` = 2 WHERE `fromid` = `toid` ;


4. Install uddeIM. When you have installed uddeIM using the Joomla installer it should have created
a folder "/images/uddeimfiles" containing two files (".htaccess" and ".index.html").

If this folder is not present uddeIM has no write access to the Joomla root folder.
In that case you should create this folder manually, see chapter
"HOW TO CREATE FOLDER '/images/uddeimfiles'"

IMPORTANT:
==========
uddeIM 1.9 has created "uddeimfiles" in Joomla root. You have to move the content of
"/uddeimfiles" to "/images/uddeimfiles" in order to keep your data.


5. Restore your uddeIM template (from step 1, when you do not use uddeIM's default templates).

ATTENTION:

There might be new icons (depending on the version of uddeIM you are updating from):
\components\com_uddeim\templates\default\images\disk.gif
\components\com_uddeim\templates\default\images\envelope.gif
\components\com_uddeim\templates\default\images\envelope_deleted.gif
\components\com_uddeim\templates\default\images\staron.gif
\components\com_uddeim\templates\default\images\staroff.gif
\components\com_uddeim\templates\default\images\icon_spam.gif
\components\com_uddeim\templates\default\images\icon_updown.gif
\components\com_uddeim\templates\default\images\icon_up.gif
\components\com_uddeim\templates\default\images\icon_down.gif
\components\com_uddeim\templates\images\rss_logo.png
When updating manually don't forget to upload these files!


6. Restore your configuration. When you have used the internal backup feature its just one click
(Tab "System"->RESTORE), otherwiese restore config.class.php from step 2. After doing that it
is important that you review the new added settings and save the new configuration!


7. Check Community Builder settings (it is not required to use CB with uddeIM but it is
highly recommended for a community platform). There are uddeIM settings for the
"cblogin" module and "mypms" plugin of the Community Builder. When possible choose
"uddeIM 2.0" otherwise the next lower version e.g. "uddeIM 1.3". It is recommended
to install the uddeIM specific modules (see the important note below).

8. Check the menu link to uddeIM. Usually you have to update the link (Joomla 1.5) or you
have to re-create the link (Joomla 1.0) so the Itemid to uddeIM is valid.


IMPORTANT:

a) plug_pms_uddeim

A plugin for the Community Builder that allows to send a "Quick message" from a
user's profile. Install this with the plugin installer in CB. You have also to publish
and configure a tab in CB. "plug_pms_uddeim" is the uddeIM-only version of
"plug_pms_mypmspro" (delivered with CB) and supports several additional features
of uddeIM.

Note: Unpublish "plug_pms_mypmspro" (delivered with CB) when you use this plugin!

b) plug_pms_uddeim_inbox

A plugin for the Community Builder that shows the content of the inbox in a profile
tab. Install this with the plugin installer in CB and you have also to publish and
configure a tab in CB.


c) mod_uddeim

A message notifier module. Install this module with the module installer. The module
provides popup notifications introduced with uddeIM 0.8.

When you do not want to have any output, switch of the module title and select
"No output" in the module configuration (so it will only do the notifications for you).

d) mod_uddeim_mailbox

A mailbox module for uddeIM. Install this module with the module installer. The module
shows some statistics and links to the inbox, outbox, trashcan, archive, settings and
compose form.

Note: Use this module on small sites only. It creates some cpu load on your database
server because of some additional queries performed on each page view.


Optional: When you want to use message obfuscating check the "key" which can be set in uddeIM
administration. Default is "uddeIMcryptkey" but it can be changed to whatever you
like. This "key" is used to obfuscate all new messages.
You cannot change this value later. You have to set it before the first new message
has been written and obfuscating of messages is enabled in the preferences.

Вы можете сделать копию вашей конфигурации базы данных и восстановить при необходимости. Это полезно, если вы обновляете uddeIM или хотите сохранить определенную конфигурацию.

uddeIM Instant Messages for Mambo/Joomla
uddeIM полностью установлен.
Пожалуйста, перейдите в меню настроек компонента.

Если вы используете кодировку Joomla, отличную от ISO 8859-1, вам также необходимо настроить ее в панели управления uddeIM.
После установки, проверьте работу uddeIM с уведомлениями по e-mail и при необходимости произведите дополнительные настройки.
Важно: когда Вы обновляете uddeIM с ранней версии, пожалуйста, прочтите README файл. В некоторых случаях Вам понадобится добавить или изменить значения или поля в Базе Данных!