KNSCore::Provider

#include <provider.h>

Inheritance diagram for KNSCore::Provider:

Classes
struct	CategoryMetadata

struct	SearchPreset

struct	SearchRequest

Public Types
enum	Filter { None , Installed , Updates , ExactEntryId }

typedef QList< Provider * >	List

enum	SearchPresetTypes { NoPresetType = 0 , GoBack , Root , Start , Popular , Featured , Recommended , Shelf , Subscription , New , FolderUp , AllEntries }

enum	SortMode { Newest , Alphabetical , Rating , Downloads }

Properties
QString	contactEmail

QUrl	host

bool	supportsSsl

QString	version

QUrl	website

Properties inherited from QObject
	objectName

Signals
void	basicsLoaded ()

void	categoriesMetadataLoded (const QList< KNSCore::Provider::CategoryMetadata > &categories)

void	commentsLoaded (const QList< std::shared_ptr< KNSCore::Comment > > comments)

void	downloadTagFilterChanged ()

void	entryDetailsLoaded (const KNSCore::Entry &)

void	loadingFailed (const KNSCore::Provider::SearchRequest &)

void	loadingFinished (const KNSCore::Provider::SearchRequest &, const KNSCore::Entry::List &)

void	payloadLinkLoaded (const KNSCore::Entry &)

void	personLoaded (const std::shared_ptr< KNSCore::Author > author)

void	providerInitialized (KNSCore::Provider *)

void	searchPresetsLoaded (const QList< KNSCore::Provider::SearchPreset > &presets)

void	signalError (const QString &)

void	signalErrorCode (KNSCore::ErrorCode::ErrorCode errorCode, const QString &message, const QVariant &metadata)

void	signalInformation (const QString &)

void	tagFilterChanged ()

Public Member Functions
	Provider ()

	~Provider () override

virtual void	becomeFan (const Entry &)

QString	contactEmail () const

QStringList	downloadTagFilter () const

QUrl	host () const

virtual QUrl	icon () const

virtual QString	id () const =0

virtual bool	isInitialized () const =0

virtual void	loadBasics ()

virtual void	loadComments (const KNSCore::Entry &, int, int)

virtual void	loadEntries (const KNSCore::Provider::SearchRequest &request)=0

virtual void	loadEntryDetails (const KNSCore::Entry &)

virtual void	loadPayloadLink (const Entry &entry, int linkId)=0

virtual void	loadPerson (const QString &)

virtual QString	name () const

virtual void	setCachedEntries (const KNSCore::Entry::List &cachedEntries)=0

void	setContactEmail (const QString &contactEmail)

void	setDownloadTagFilter (const QStringList &downloadTagFilter)

void	setHost (const QUrl &host)

virtual bool	setProviderXML (const QDomElement &xmldata)=0

void	setSupportsSsl (bool supportsSsl)

void	setTagFilter (const QStringList &tagFilter)

void	setVersion (const QString &version)

void	setWebsite (const QUrl &website)

bool	supportsSsl () const

QStringList	tagFilter () const

virtual bool	userCanBecomeFan ()

virtual bool	userCanVote ()

QString	version () const

virtual void	vote (const Entry &, uint)

QUrl	website () const

Public Member Functions inherited from QObject
	QObject (QObject *parent)

QBindable< QString >	bindableObjectName ()

bool	blockSignals (bool block)

const QObjectList &	children () const const

QMetaObject::Connection	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const const

void	deleteLater ()

void	destroyed (QObject *obj)

bool	disconnect (const char signal, const QObject receiver, const char *method) const const

bool	disconnect (const QObject receiver, const char method) const const

void	dumpObjectInfo () const const

void	dumpObjectTree () const const

QList< QByteArray >	dynamicPropertyNames () const const

virtual bool	event (QEvent *e)

virtual bool	eventFilter (QObject watched, QEvent event)

T	findChild (const QString &name, Qt::FindChildOptions options) const const

QList< T >	findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const

QList< T >	findChildren (const QString &name, Qt::FindChildOptions options) const const

QList< T >	findChildren (Qt::FindChildOptions options) const const

bool	inherits (const char *className) const const

void	installEventFilter (QObject *filterObj)

bool	isQuickItemType () const const

bool	isWidgetType () const const

bool	isWindowType () const const

void	killTimer (int id)

virtual const QMetaObject *	metaObject () const const

void	moveToThread (QThread *targetThread)

QString	objectName () const const

void	objectNameChanged (const QString &objectName)

QObject *	parent () const const

QVariant	property (const char *name) const const

	Q_CLASSINFO (Name, Value)

	Q_EMIT Q_EMIT

	Q_ENUM (...)

	Q_ENUM_NS (...)

	Q_ENUMS (...)

	Q_FLAG (...)

	Q_FLAG_NS (...)

	Q_FLAGS (...)

	Q_GADGET Q_GADGET

	Q_GADGET_EXPORT (EXPORT_MACRO)

	Q_INTERFACES (...)

	Q_INVOKABLE Q_INVOKABLE

	Q_MOC_INCLUDE Q_MOC_INCLUDE

	Q_NAMESPACE Q_NAMESPACE

	Q_NAMESPACE_EXPORT (EXPORT_MACRO)

	Q_OBJECT Q_OBJECT

	Q_PROPERTY (...)

	Q_REVISION Q_REVISION

	Q_SET_OBJECT_NAME (Object)

	Q_SIGNAL Q_SIGNAL

	Q_SIGNALS Q_SIGNALS

	Q_SLOT Q_SLOT

	Q_SLOTS Q_SLOTS

T	qobject_cast (const QObject *object)

T	qobject_cast (QObject *object)

	QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT

void	removeEventFilter (QObject *obj)

void	setObjectName (const QString &name)

void	setObjectName (QAnyStringView name)

void	setParent (QObject *parent)

bool	setProperty (const char *name, const QVariant &value)

bool	setProperty (const char *name, QVariant &&value)

bool	signalsBlocked () const const

int	startTimer (int interval, Qt::TimerType timerType)

int	startTimer (std::chrono::milliseconds interval, Qt::TimerType timerType)

QThread *	thread () const const

Protected Member Functions
void	setIcon (const QUrl &icon)

void	setName (const QString &name)

Protected Member Functions inherited from QObject
virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const QMetaMethod &signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const QMetaMethod &signal)

bool	isSignalConnected (const QMetaMethod &signal) const const

int	receivers (const char *signal) const const

QObject *	sender () const const

int	senderSignalIndex () const const

virtual void	timerEvent (QTimerEvent *event)

Additional Inherited Members
Static Public Member Functions inherited from QObject
QMetaObject::Connection	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject context, Functor functor, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject receiver, PointerToMemberFunction method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)

bool	disconnect (const QMetaObject::Connection &connection)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

bool	disconnect (const QObject sender, PointerToMemberFunction signal, const QObject receiver, PointerToMemberFunction method)

QString	tr (const char sourceText, const char disambiguation, int n)

Public Attributes inherited from QObject
typedef	QObjectList

Detailed Description

KNewStuff Base Provider class.

This class provides accessors for the provider object. It should not be used directly by the application. This class is the base class and will be instantiated for static website providers.

Author: Jeremy Whiting jpwhi.nosp@m.ting.nosp@m.@kde..nosp@m.org

Deprecated: since 6.9 Use ProviderBase to implement providers (only in-tree supported). Use ProviderCore to manage instances of base.

Definition at line 42 of file provider.h.

Member Typedef Documentation

◆ List

typedef QList<Provider *> KNSCore::Provider::List

Definition at line 55 of file provider.h.

Member Enumeration Documentation

◆ Filter

enum KNSCore::Provider::Filter

Definition at line 65 of file provider.h.

◆ SearchPresetTypes

enum KNSCore::Provider::SearchPresetTypes

The SearchPresetTypes enum the preset type enum is a helper to identify the kind of label and icon the search preset should have if none are found.

Since: 5.83

Deprecated: since 6.9 Use KNSCore::SearchPreset::SearchPresetTypes

Enumerator
GoBack	preset representing the previous search.
Root	preset indicating a root directory.
Start	preset indicating the first entry.
Popular	preset indicating popular items.
Featured	preset for featured items.
Recommended	preset for recommended. This may be customized by the server per user.
Shelf	preset indicating previously acquired items.
Subscription	preset indicating items that the user is subscribed to.
New	preset indicating new items.
FolderUp	preset indicating going up in the search result hierarchy.
AllEntries	preset indicating all possible entries, such as a crawlable list. Might be intense to load.

Definition at line 125 of file provider.h.

◆ SortMode

enum KNSCore::Provider::SortMode

Definition at line 57 of file provider.h.

Property Documentation

◆ contactEmail

QString KNSCore::Provider::contactEmail

readwrite

Definition at line 52 of file provider.h.

◆ host

QUrl KNSCore::Provider::host

readwrite

Definition at line 51 of file provider.h.

◆ supportsSsl

bool KNSCore::Provider::supportsSsl

readwrite

Definition at line 53 of file provider.h.

◆ version

QString KNSCore::Provider::version

readwrite

Definition at line 49 of file provider.h.

◆ website

QUrl KNSCore::Provider::website

readwrite

Definition at line 50 of file provider.h.

Constructor & Destructor Documentation

◆ Provider()

KNSCore::Provider::Provider ( )

Constructor.

Definition at line 31 of file provider.cpp.

◆ ~Provider()

KNSCore::Provider::~Provider ( )

overridedefault

Destructor.

Member Function Documentation

◆ basicsLoaded

void KNSCore::Provider::basicsLoaded ( )

signal

Fired when the provider's basic information has been fetched and updated.

Since: 5.85

◆ becomeFan()

virtual void KNSCore::Provider::becomeFan ( const Entry & )

inlinevirtual

Definition at line 320 of file provider.h.

◆ commentsLoaded

void KNSCore::Provider::commentsLoaded ( const QList< std::shared_ptr< KNSCore::Comment > > comments )

signal

Fired when new comments have been loaded.

Parameters

comments The list of newly loaded comments, in a depth-first order

Since: 5.63

◆ contactEmail()

QString KNSCore::Provider::contactEmail ( ) const

The general contact email for this provider.

Returns: The general contact email for this provider

Since: 5.85

Definition at line 126 of file provider.cpp.

◆ downloadTagFilter()

QStringList KNSCore::Provider::downloadTagFilter ( ) const

The tag filter used for downloads by this provider.

Returns: The list of filters

See also: Engine::setDownloadTagFilter(QStringList)

Since: 5.51

Definition at line 65 of file provider.cpp.

◆ host()

QUrl KNSCore::Provider::host ( ) const

Since: 5.85

Definition at line 112 of file provider.cpp.

◆ icon()

QUrl KNSCore::Provider::icon ( ) const

virtual

Retrieves the icon URL for this provider.

Returns: icon URL

Definition at line 43 of file provider.cpp.

◆ id()

virtual QString KNSCore::Provider::id ( ) const

pure virtual

A unique Id for this provider (the url in most cases)

◆ loadBasics()

virtual void KNSCore::Provider::loadBasics ( )

inlinevirtual

Request loading of the basic information for this provider.

The engine listens to the basicsLoaded() signal for the result, which is also the signal the respective properties listen to.

This is fired automatically on the first attempt to read one of the properties which contain this basic information, and you will not need to call it as a user of the class (just listen to the properties, which will update when the information has been fetched).

Note: Implementation detail: All subclasses should connect to this signal and point it at a slot which does the actual work, if they support fetching this basic information (if the information is set during construction, you will not need to worry about this).

See also: version(); website(); host();; contactEmail(); supportsSsl()

Since: 5.85

Definition at line 254 of file provider.h.

◆ loadComments()

virtual void KNSCore::Provider::loadComments	(	const KNSCore::Entry &	,
		int	,
		int	)

inlinevirtual

Request a loading of comments from this provider.

The engine listens to the commentsLoaded() signal for the result

Note: Implementation detail: All subclasses should connect to this signal and point it at a slot which does the actual work, if they support comments.

See also: commentsLoaded(const QList<shared_ptr<KNSCore::Comment>> comments)

Since: 5.63

Definition at line 215 of file provider.h.

◆ loadEntries()

virtual void KNSCore::Provider::loadEntries ( const KNSCore::Provider::SearchRequest & request )

pure virtual

load the given search and return given page

Parameters

sortMode	string to select the order in which the results are presented
searchstring	string to search with
page	page number to load

Note: the engine connects to loadingFinished() signal to get the result

◆ loadEntryDetails()

virtual void KNSCore::Provider::loadEntryDetails ( const KNSCore::Entry & )

inlinevirtual

Definition at line 201 of file provider.h.

◆ loadPerson()

virtual void KNSCore::Provider::loadPerson ( const QString & )

inlinevirtual

Request loading of the details for a specific person with the given username.

The engine listens to the personLoaded() for the result

Note: Implementation detail: All subclasses should connect to this signal and point it at a slot which does the actual work, if they support comments.

Since: 5.63

Definition at line 228 of file provider.h.

◆ name()

QString KNSCore::Provider::name ( ) const

virtual

Retrieves the common name of the provider.

Returns: provider name

Definition at line 38 of file provider.cpp.

◆ personLoaded

void KNSCore::Provider::personLoaded ( const std::shared_ptr< KNSCore::Author > author )

signal

Fired when the details of a person have been loaded.

Parameters

author The person we've just loaded data for

Since: 5.63

◆ searchPresetsLoaded

void KNSCore::Provider::searchPresetsLoaded ( const QList< KNSCore::Provider::SearchPreset > & presets )

signal

Fires when the provider has loaded search presets.

These represent interesting searches for the user, such as recommendations.

Since: 5.83

◆ setContactEmail()

void KNSCore::Provider::setContactEmail ( const QString & contactEmail )

Sets the general contact email address for this provider.

Parameters

contactEmail The general contact email for this provider

Since: 5.85

Definition at line 132 of file provider.cpp.

◆ setDownloadTagFilter()

void KNSCore::Provider::setDownloadTagFilter ( const QStringList & downloadTagFilter )

Set the tag filter used for download items by this provider.

Parameters

downloadTagFilter The new list of filters

See also: Engine::setDownloadTagFilter(QStringList)

Since: 5.51

Definition at line 59 of file provider.cpp.

◆ setHost()

void KNSCore::Provider::setHost ( const QUrl & host )

Parameters

host	The host used for this provider

Since: 5.85

Definition at line 118 of file provider.cpp.

◆ setIcon()

void KNSCore::Provider::setIcon ( const QUrl & icon )

protected

Definition at line 159 of file provider.cpp.

◆ setName()

void KNSCore::Provider::setName ( const QString & name )

protected

Definition at line 154 of file provider.cpp.

◆ setProviderXML()

virtual bool KNSCore::Provider::setProviderXML ( const QDomElement & xmldata )

pure virtual

Set the provider data xml, to initialize the provider.

The Provider needs to have it's ID set in this function and cannot change it from there on.

◆ setSupportsSsl()

void KNSCore::Provider::setSupportsSsl ( bool supportsSsl )

Set whether or not the provider supports SSL connections.

Parameters

supportsSsl True if the server supports SSL connections, false if not

Since: 5.85

Definition at line 146 of file provider.cpp.

◆ setTagFilter()

void KNSCore::Provider::setTagFilter ( const QStringList & tagFilter )

Set the tag filter used for entries by this provider.

Parameters

tagFilter The new list of filters

See also: Engine::setTagFilter(QStringList)

Since: 5.51

Definition at line 48 of file provider.cpp.

◆ setVersion()

void KNSCore::Provider::setVersion ( const QString & version )

Since: 5.85

Definition at line 90 of file provider.cpp.

◆ setWebsite()

void KNSCore::Provider::setWebsite ( const QUrl & website )

Since: 5.85

Definition at line 104 of file provider.cpp.

◆ supportsSsl()

bool KNSCore::Provider::supportsSsl ( ) const

Whether or not the provider supports SSL connections.

Returns: True if the server supports SSL connections, false if not

Since: 5.85

Definition at line 140 of file provider.cpp.

◆ tagFilter()

QStringList KNSCore::Provider::tagFilter ( ) const

The tag filter used for downloads by this provider.

Returns: The list of filters

See also: Engine::setTagFilter(QStringList)

Since: 5.51

Definition at line 54 of file provider.cpp.

◆ userCanBecomeFan()

virtual bool KNSCore::Provider::userCanBecomeFan ( )

inlinevirtual

Definition at line 316 of file provider.h.

◆ userCanVote()

virtual bool KNSCore::Provider::userCanVote ( )

inlinevirtual

Definition at line 308 of file provider.h.

◆ version()

QString KNSCore::Provider::version ( ) const

Since: 5.85

Definition at line 84 of file provider.cpp.

◆ vote()

virtual void KNSCore::Provider::vote	(	const Entry &	,
		uint	)

inlinevirtual

Definition at line 312 of file provider.h.

◆ website()

QUrl KNSCore::Provider::website ( ) const

Since: 5.85

Definition at line 98 of file provider.cpp.

The documentation for this class was generated from the following files:

KDE's Doxygen guidelines are available online.

Class Picker

Quick Links

About KNewStuff

KNSCore::Provider

Classes

Public Types

Properties

Signals

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ List

Member Enumeration Documentation

◆ Filter

◆ SearchPresetTypes

◆ SortMode

Property Documentation

◆ contactEmail

◆ host

◆ supportsSsl

◆ version

◆ website

Constructor & Destructor Documentation

◆ Provider()

◆ ~Provider()

Member Function Documentation

◆ basicsLoaded

◆ becomeFan()

◆ commentsLoaded

◆ contactEmail()

◆ downloadTagFilter()

◆ host()

◆ icon()

◆ id()

◆ loadBasics()

◆ loadComments()

◆ loadEntries()

◆ loadEntryDetails()

◆ loadPerson()

◆ name()

◆ personLoaded

◆ searchPresetsLoaded

◆ setContactEmail()

◆ setDownloadTagFilter()

◆ setHost()

◆ setIcon()

◆ setName()

◆ setProviderXML()

◆ setSupportsSsl()

◆ setTagFilter()

◆ setVersion()

◆ setWebsite()

◆ supportsSsl()

◆ tagFilter()

◆ userCanBecomeFan()

◆ userCanVote()

◆ version()

◆ vote()

◆ website()