Obsolete Members for QXmppClientExtension

The following members of class QXmppClientExtension are deprecated. They are provided to keep old source code working. We strongly advise against using them in new code.

Public Functions

(deprecated) virtual QStringList discoveryFeatures() const
(deprecated) virtual QList<QXmppDiscoIdentity> discoveryIdentities() const
(deprecated) virtual bool handleStanza(const QDomElement &stanza)
(since QXmpp 1.5, deprecated) virtual bool handleStanza(const QDomElement &stanza, const std::optional<QXmppE2eeMetadata> &e2eeMetadata)

Member Function Documentation

[virtual, deprecated] QStringList QXmppClientExtension::discoveryFeatures() const

This function is deprecated. We strongly advise against using it in new code.

Returns the discovery features to add to the client.

since QXmpp 1.18, add the features via the QXmpp::Disco::CollectInfo hook instead. Implementations are still used, after the handlers of the hook.

[virtual, deprecated] QList<QXmppDiscoIdentity> QXmppClientExtension::discoveryIdentities() const

This function is deprecated. We strongly advise against using it in new code.

Returns the discovery identities to add to the client.

since QXmpp 1.18, add the identities via the QXmpp::Disco::CollectInfo hook instead. Implementations are still used, after the handlers of the hook.

[virtual, deprecated] bool QXmppClientExtension::handleStanza(const QDomElement &stanza)

This function is deprecated. We strongly advise against using it in new code.

You need to implement this method to process incoming XMPP stanzas.

You should return true if the stanza was handled and no further processing should occur, or false to let other extensions process the stanza.

End-to-end encrypted stanzas are not passed to this overload, for that purpose use the new overload instead.

This is deprecated since QXmpp 1.5. Please add a handler to the QXmpp::Client::StanzaReceived hook instead. Currently both methods are called by the client, so only implement one!

[virtual, since QXmpp 1.5, deprecated] bool QXmppClientExtension::handleStanza(const QDomElement &stanza, const std::optional<QXmppE2eeMetadata> &e2eeMetadata)

This function is deprecated. We strongly advise against using it in new code.

You need to implement this method to process incoming XMPP stanzas.

stanza is the DOM element to be handled. e2eeMetadata, if the element has been decrypted, contains metadata about the encryption.

Returns true if the stanza was handled and no further processing should occur, or false to let other extensions process the stanza.

since QXmpp 1.18, add a handler to the QXmpp::Client::StanzaReceived hook instead. Implementations are still called, after the handlers of the hook.

This function was introduced in QXmpp 1.5.