kopete/PORTING_KDE4

   1 Last update: 27 december 2006.
   2
   3 This is a non-exhaustive guide to porting code from Kopete >= 0.11 (based on KDE3.x) to Kopete4 (based on KDE 4.x).
   4
   5 Libkopete changes
   6 -----------------
   7 *) Kopete::Account
   8    - contacts() now return a const QHash<QString,Contact*>&
   9    - setOnlineStatus() reason optional parameter use Kopete::StatusMessage.
  10    - NEW: setStatusMessage() which take a Kopete::StatusMessage.
  11
  12 *) Kopete::AccountManager
  13    - accounts() now return a QList<Account*>.
  14
  15 *) KopeteAwayDialog
  16    - removed. KopeteAwayAction should be used instead
  17
  18 *) Kopete::ChatSessionManager
  19    - sessions() now return a QList<ChatSession*>
  20
  21 *) kopetecommandlist.h
  22    - CommandList is now a QMultiHash<QString, Command*>
  23
  24 *) Kopete::Contact
  25    - NEW: setStatusMessage() and statusMessage().
  26
  27 *) kopetecontactproperty.h
  28    - Removed bool flags from constructor. Use ContactPropertyOption enum instead.
  29      First bool parameter -> Kopete::ContactPropertyTmpl::PersistentProperty
  30      Second bool parameter -> Kopete::ContactPropertyTmpl::RichTextProperty
  31      Third bool parameter -> Kopete::ContactProperyTmpl::PrivateProperty
  32
  33 *) kopeteglobal.h
  34    - Renamed Kopete::Global::Properties::awayMessage() to statusMessage()
  35
  36 *) Kopete::MetaContact
  37    - photo() is now deprecated. Use picture().image() instead.
  38
  39 *) Kopete::Message
  40    - asXML() no longer exist (removed in 0.12)
  41
  42 *) Kopete::OnlineStatusManager
  43    - HasAwayMessage enum value was renamed to HasStatusMessage.
  44
  45 *) NEW: Kopete::StatusMessage
  46    Class that encapsulate normal status message and status metadata(like Now Listening metadata)
  47
  48 *) kopeteproperties.h
  49    - Replaced PortingDict, now a QMultiHash<QByteArray, PropertyData
  50    - Replaced all const char * parameters with const QByteArray &
  51
  52 *) KopetePrefs
  53    - Removed. Use the new settings classes (see entry below).
  54
  55 *) kopetexsl.h
  56    - Was removed in 0.12 version.
  57
  58
  59 -kopetemessagemanager.h and kopetemessagemanagerfactory.h has been removed. Use kopetechatsession.h and kopetechatsessionmanager.h
  60
  61 *) Configuration/Settings classes changes.
  62
  63 KopetePrefs is deprecated and will be removed soon. Please use the new settings classes generated by KConfigXT.
  64 -Kopete::AppearanceSettings is for settings related to appearance like fonts, colors and enabled visual items
  65 -Kopete::BehaviorSetting is for settings related to Kopete's behavior.
  66 -Kopete::Config was renamed to Kopete::GeneralSettings.
  67
  68 See related .kcfg files for possible entries.
  69
  70 Other changes
  71 -------------
  72 If you get problems with UI files that fuck because of some KDE widgets,
  73 add those lines to the .ui file (open it as text). Note that it's just a exemple.
  74
  75 <customwidgets>
  76     <customwidget>
  77        <class>KHistoryCombo</class>
  78        <header>kcombobox.h</header>
  79     </customwidget>
  80     <customwidget>
  81        <class>KPasswordEdit</class>
  82        <header>kpassdlg.h</header>
  83     </customwidget>
  84 </customwidgets>