1 /*****************************************************************************
2 * Copyright (C) 2008 by Sebastian Trueg <trueg@kde.org> *
3 * Copyright (C) 2009 by Peter Penz <peter.penz@gmx.at> *
5 * This library is free software; you can redistribute it and/or *
6 * modify it under the terms of the GNU Library General Public *
7 * License version 2 as published by the Free Software Foundation. *
9 * This library is distributed in the hope that it will be useful, *
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
12 * Library General Public License for more details. *
14 * You should have received a copy of the GNU Library General Public License *
15 * along with this library; see the file COPYING.LIB. If not, write to *
16 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, *
17 * Boston, MA 02110-1301, USA. *
18 *****************************************************************************/
20 #include "kmetadatawidget.h"
23 #include <kconfiggroup.h>
24 #include <kfileitem.h>
25 #include <kglobalsettings.h>
30 #include <QFontMetrics>
31 #include <QGridLayout>
36 #include <config-nepomuk.h>
38 #define DISABLE_NEPOMUK_LEGACY
40 #include "kcommentwidget_p.h"
41 #include "kloadmetadatathread_p.h"
42 #include "ktaggingwidget_p.h"
44 #include <nepomuk/kratingwidget.h>
45 #include <nepomuk/resource.h>
46 #include <nepomuk/resourcemanager.h>
47 #include <nepomuk/property.h>
48 #include <nepomuk/tag.h>
49 #include <nepomuk/variant.h>
50 #include "nepomukmassupdatejob_p.h"
53 #include <QSpacerItem>
62 class KMetaDataWidget::Private
71 Private(KMetaDataWidget
* parent
);
74 void addRow(QLabel
* label
, QWidget
* infoWidget
);
75 void removeMetaInfoRows();
76 void setRowVisible(QWidget
* infoWidget
, bool visible
);
79 * Initializes the configuration file "kmetainformationrc"
80 * with proper default settings for the first start in
81 * an uninitialized environment.
83 void initMetaInfoSettings();
86 * Parses the configuration file "kmetainformationrc" and
87 * updates the visibility of all rows.
89 void updateRowsVisibility();
91 void slotLoadingFinished();
93 void slotRatingChanged(unsigned int rating
);
94 void slotTagsChanged(const QList
<Nepomuk::Tag
>& tags
);
95 void slotCommentChanged(const QString
& comment
);
97 void slotMetaDataUpdateDone();
98 void slotLinkActivated(const QString
& link
);
101 void slotTagActivated(const Nepomuk::Tag
& tag
);
104 * Disables the metadata widget and starts the job that
105 * changes the meta data asynchronously. After the job
106 * has been finished, the metadata widget gets enabled again.
108 void startChangeDataJob(KJob
* job
);
111 * Merges items like 'width' and 'height' as one item.
113 QList
<KLoadMetaDataThread::Item
> mergedItems(const QList
<KLoadMetaDataThread::Item
>& items
);
118 bool m_nepomukActivated
;
119 MetaDataTypes m_visibleDataTypes
;
120 QList
<KFileItem
> m_fileItems
;
123 QGridLayout
* m_gridLayout
;
128 QLabel
* m_modifiedInfo
;
130 QLabel
* m_permissionsInfo
;
133 KRatingWidget
* m_ratingWidget
;
134 KTaggingWidget
* m_taggingWidget
;
135 KCommentWidget
* m_commentWidget
;
137 QMap
<KUrl
, Nepomuk::Resource
> m_files
;
139 KLoadMetaDataThread
* m_loadMetaDataThread
;
143 KMetaDataWidget
* const q
;
146 KMetaDataWidget::Private::Private(KMetaDataWidget
* parent
) :
149 m_nepomukActivated(false),
150 m_visibleDataTypes(TypeData
| SizeData
| ModifiedData
| OwnerData
|
151 PermissionsData
| RatingData
| TagsData
| CommentData
),
160 m_permissionsInfo(0),
166 m_loadMetaDataThread(0),
170 const QFontMetrics
fontMetrics(KGlobalSettings::smallestReadableFont());
172 m_gridLayout
= new QGridLayout(parent
);
173 m_gridLayout
->setMargin(0);
174 m_gridLayout
->setSpacing(fontMetrics
.height() / 4);
176 m_typeInfo
= new QLabel(parent
);
177 m_sizeLabel
= new QLabel(parent
);
178 m_sizeInfo
= new QLabel(parent
);
179 m_modifiedInfo
= new QLabel(parent
);
180 m_ownerInfo
= new QLabel(parent
);
181 m_permissionsInfo
= new QLabel(parent
);
184 m_nepomukActivated
= (Nepomuk::ResourceManager::instance()->init() == 0);
185 if (m_nepomukActivated
) {
186 m_ratingWidget
= new KRatingWidget(parent
);
187 m_ratingWidget
->setFixedHeight(fontMetrics
.height());
188 connect(m_ratingWidget
, SIGNAL(ratingChanged(unsigned int)),
189 q
, SLOT(slotRatingChanged(unsigned int)));
191 m_taggingWidget
= new KTaggingWidget(parent
);
192 connect(m_taggingWidget
, SIGNAL(tagsChanged(const QList
<Nepomuk::Tag
>&)),
193 q
, SLOT(slotTagsChanged(const QList
<Nepomuk::Tag
>&)));
194 connect(m_taggingWidget
, SIGNAL(tagActivated(const Nepomuk::Tag
&)),
195 q
, SLOT(slotTagActivated(const Nepomuk::Tag
&)));
197 m_commentWidget
= new KCommentWidget(parent
);
198 connect(m_commentWidget
, SIGNAL(commentChanged(const QString
&)),
199 q
, SLOT(slotCommentChanged(const QString
&)));
203 initMetaInfoSettings();
206 KMetaDataWidget::Private::~Private()
209 if (m_loadMetaDataThread
!= 0) {
210 disconnect(m_loadMetaDataThread
, SIGNAL(finished()), q
, SLOT(slotLoadingFinished()));
211 m_loadMetaDataThread
->cancelAndDelete();
212 m_loadMetaDataThread
= 0;
217 void KMetaDataWidget::Private::addRow(QLabel
* label
, QWidget
* infoWidget
)
221 row
.infoWidget
= infoWidget
;
224 const QFont smallFont
= KGlobalSettings::smallestReadableFont();
225 // use a brighter color for the label and a small font size
226 QPalette palette
= label
->palette();
227 const QPalette::ColorRole role
= q
->foregroundRole();
228 QColor textColor
= palette
.color(role
);
229 textColor
.setAlpha(128);
230 palette
.setColor(role
, textColor
);
231 label
->setPalette(palette
);
232 label
->setForegroundRole(role
);
233 label
->setFont(smallFont
);
234 label
->setWordWrap(true);
235 label
->setAlignment(Qt::AlignTop
| Qt::AlignRight
);
237 infoWidget
->setForegroundRole(role
);
238 QLabel
* infoLabel
= qobject_cast
<QLabel
*>(infoWidget
);
239 if (infoLabel
!= 0) {
240 infoLabel
->setFont(smallFont
);
241 infoLabel
->setWordWrap(true);
242 infoLabel
->setAlignment(Qt::AlignTop
| Qt::AlignLeft
);
245 // add the row to grid layout
246 const int rowIndex
= m_rows
.count();
247 m_gridLayout
->addWidget(label
, rowIndex
, 0, Qt::AlignRight
);
248 const int spacerWidth
= QFontMetrics(smallFont
).size(Qt::TextSingleLine
, " ").width();
249 m_gridLayout
->addItem(new QSpacerItem(spacerWidth
, 1), rowIndex
, 1);
250 m_gridLayout
->addWidget(infoWidget
, rowIndex
, 2, Qt::AlignLeft
);
253 void KMetaDataWidget::Private::setRowVisible(QWidget
* infoWidget
, bool visible
)
255 foreach (const Row
& row
, m_rows
) {
256 if (row
.infoWidget
== infoWidget
) {
257 row
.label
->setVisible(visible
);
258 row
.infoWidget
->setVisible(visible
);
265 void KMetaDataWidget::Private::initMetaInfoSettings()
267 static const int s_metainformationrcVersion
= 1;
268 KConfig
config("kmetainformationrc", KConfig::NoGlobals
);
269 if (config
.group( "Misc" ).readEntry("version", 0) < s_metainformationrcVersion
) {
270 // The resource file is read the first time. Assure
271 // that some meta information is disabled per default.
274 config
.deleteGroup( "Show" );
275 KConfigGroup settings
= config
.group("Show");
277 // trueg: KDE 4.5: use a blacklist of actual rdf properties
279 static const char* disabledProperties
[] = {
280 "asText", "contentSize", "created", "depth", "description", "fileExtension",
281 "fileName", "fileSize", "hasTag", "isPartOf", "lastModified", "mimeType", "name",
282 "numericRating", "parentUrl", "permissions", "plainTextContent", "owner",
283 "sourceModified", "url",
284 0 // mandatory last entry
287 for (int i
= 0; disabledProperties
[i
] != 0; ++i
) {
288 settings
.writeEntry(disabledProperties
[i
], false);
291 // mark the group as initialized
292 config
.group( "Misc" ).writeEntry("version", s_metainformationrcVersion
);
296 void KMetaDataWidget::Private::updateRowsVisibility()
298 KConfig
config("kmetainformationrc", KConfig::NoGlobals
);
299 KConfigGroup settings
= config
.group("Show");
301 setRowVisible(m_typeInfo
,
302 (m_visibleDataTypes
& KMetaDataWidget::TypeData
) &&
303 settings
.readEntry("type", true));
305 // Cache in m_sizeVisible whether the size should be shown. This
306 // is necessary as the size is temporary hidden when the target
307 // file item is a directory.
308 m_sizeVisible
= (m_visibleDataTypes
& KMetaDataWidget::SizeData
) &&
309 settings
.readEntry("size", true);
310 setRowVisible(m_sizeInfo
, m_sizeVisible
);
312 setRowVisible(m_modifiedInfo
,
313 (m_visibleDataTypes
& KMetaDataWidget::ModifiedData
) &&
314 settings
.readEntry("modified", true));
316 setRowVisible(m_ownerInfo
,
317 (m_visibleDataTypes
& KMetaDataWidget::OwnerData
) &&
318 settings
.readEntry("owner", true));
320 setRowVisible(m_permissionsInfo
,
321 (m_visibleDataTypes
& KMetaDataWidget::PermissionsData
) &&
322 settings
.readEntry("permissions", true));
325 if (m_nepomukActivated
) {
326 setRowVisible(m_ratingWidget
,
327 (m_visibleDataTypes
& KMetaDataWidget::RatingData
) &&
328 settings
.readEntry("rating", true));
330 setRowVisible(m_taggingWidget
,
331 (m_visibleDataTypes
& KMetaDataWidget::TagsData
) &&
332 settings
.readEntry("tags", true));
334 setRowVisible(m_commentWidget
,
335 (m_visibleDataTypes
& KMetaDataWidget::CommentData
) &&
336 settings
.readEntry("comment", true));
341 void KMetaDataWidget::Private::slotLoadingFinished()
344 Q_ASSERT(m_loadMetaDataThread
!= 0);
345 Q_ASSERT(m_ratingWidget
!= 0);
346 Q_ASSERT(m_commentWidget
!= 0);
347 Q_ASSERT(m_taggingWidget
!= 0);
348 m_ratingWidget
->setRating(m_loadMetaDataThread
->rating());
349 m_commentWidget
->setText(m_loadMetaDataThread
->comment());
350 m_taggingWidget
->setTags(m_loadMetaDataThread
->tags());
352 // Show the remaining meta information as text. The number
353 // of required rows may very. Existing rows are reused to
354 // prevent flickering.
355 int index
= 8; // TODO: don't hardcode this value here
356 const int rowCount
= m_rows
.count();
357 Q_ASSERT(rowCount
>= index
);
359 const QList
<KLoadMetaDataThread::Item
> items
= mergedItems(m_loadMetaDataThread
->items());
360 foreach (const KLoadMetaDataThread::Item
& item
, items
) {
361 if (index
< rowCount
) {
362 // adjust texts of the current row
363 m_rows
[index
].label
->setText(item
.label
);
364 QLabel
* infoValueLabel
= qobject_cast
<QLabel
*>(m_rows
[index
].infoWidget
);
365 Q_ASSERT(infoValueLabel
!= 0);
366 infoValueLabel
->setText(item
.value
);
369 QLabel
* infoLabel
= new QLabel(item
.label
, q
);
370 QLabel
* infoValue
= new QLabel(item
.value
, q
);
371 connect(infoValue
, SIGNAL(linkActivated(QString
)),
372 q
, SLOT(slotLinkActivated(QString
)));
373 addRow(infoLabel
, infoValue
);
377 if (items
.count() > 0) {
381 // remove rows that are not needed anymore
382 for (int i
= m_rows
.count() - 1; i
>= index
; --i
) {
383 delete m_rows
[i
].label
;
384 delete m_rows
[i
].infoWidget
;
388 m_files
= m_loadMetaDataThread
->files();
390 delete m_loadMetaDataThread
;
391 m_loadMetaDataThread
= 0;
397 void KMetaDataWidget::Private::slotRatingChanged(unsigned int rating
)
400 Nepomuk::MassUpdateJob
* job
=
401 Nepomuk::MassUpdateJob::rateResources(m_files
.values(), rating
);
402 startChangeDataJob(job
);
408 void KMetaDataWidget::Private::slotTagsChanged(const QList
<Nepomuk::Tag
>& tags
)
411 m_taggingWidget
->setTags(tags
);
413 Nepomuk::MassUpdateJob
* job
=
414 Nepomuk::MassUpdateJob::tagResources(m_files
.values(), tags
);
415 startChangeDataJob(job
);
421 void KMetaDataWidget::Private::slotCommentChanged(const QString
& comment
)
424 Nepomuk::MassUpdateJob
* job
=
425 Nepomuk::MassUpdateJob::commentResources(m_files
.values(), comment
);
426 startChangeDataJob(job
);
433 void KMetaDataWidget::Private::slotTagActivated(const Nepomuk::Tag
& tag
)
435 emit q
->urlActivated(tag
.resourceUri());
439 void KMetaDataWidget::Private::slotMetaDataUpdateDone()
446 void KMetaDataWidget::Private::slotLinkActivated(const QString
& link
)
448 emit q
->urlActivated(KUrl(link
));
452 void KMetaDataWidget::Private::startChangeDataJob(KJob
* job
)
454 connect(job
, SIGNAL(result(KJob
*)),
455 q
, SLOT(slotMetaDataUpdateDone()));
456 q
->setEnabled(false); // no updates during execution
460 QList
<KLoadMetaDataThread::Item
>
461 KMetaDataWidget::Private::mergedItems(const QList
<KLoadMetaDataThread::Item
>& items
)
463 // TODO: Currently only "width" and "height" are merged as "width x height". If
464 // other kind of merges should be done too, a more general approach is required.
465 QList
<KLoadMetaDataThread::Item
> mergedItems
;
467 KLoadMetaDataThread::Item width
;
468 KLoadMetaDataThread::Item height
;
470 foreach (const KLoadMetaDataThread::Item
& item
, items
) {
471 if (item
.name
== "width") {
473 } else if (item
.name
== "height") {
476 // insert the item sorted by the label
477 bool inserted
= false;
479 const int count
= mergedItems
.count();
480 while (!inserted
&& (i
< count
)) {
481 if (item
.label
< mergedItems
[i
].label
) {
482 mergedItems
.insert(i
, item
);
488 mergedItems
.append(item
);
493 const bool foundWidth
= !width
.name
.isEmpty();
494 const bool foundHeight
= !height
.name
.isEmpty();
495 if (foundWidth
&& !foundHeight
) {
496 mergedItems
.insert(0, width
);
497 } else if (foundHeight
&& !foundWidth
) {
498 mergedItems
.insert(0, height
);
499 } else if (foundWidth
&& foundHeight
) {
500 KLoadMetaDataThread::Item size
;
501 size
.label
= i18nc("@label", "Width x Height:");
502 size
.value
= width
.value
+ " x " + height
.value
;
503 mergedItems
.insert(0, size
);
510 KMetaDataWidget::KMetaDataWidget(QWidget
* parent
) :
516 KMetaDataWidget::~KMetaDataWidget()
521 void KMetaDataWidget::setItem(const KFileItem
& item
)
523 // update values for "type", "size", "modified",
524 // "owner" and "permissions" synchronously
525 d
->m_sizeLabel
->setText(i18nc("@label", "Size:"));
527 d
->m_typeInfo
->setText(i18nc("@label", "Folder"));
528 d
->setRowVisible(d
->m_sizeInfo
, false);
530 d
->m_typeInfo
->setText(item
.mimeComment());
531 d
->m_sizeInfo
->setText(KIO::convertSize(item
.size()));
532 d
->setRowVisible(d
->m_sizeInfo
, d
->m_sizeVisible
);
534 d
->m_modifiedInfo
->setText(KGlobal::locale()->formatDateTime(item
.time(KFileItem::ModificationTime
), KLocale::FancyLongDate
));
535 d
->m_ownerInfo
->setText(item
.user());
536 d
->m_permissionsInfo
->setText(item
.permissionsString());
538 setItems(KFileItemList() << item
);
541 void KMetaDataWidget::setItems(const KFileItemList
& items
)
543 d
->m_fileItems
= items
;
545 if (items
.count() > 1) {
546 // calculate the size of all items and show this
547 // information to the user
548 d
->m_sizeLabel
->setText(i18nc("@label", "Total Size:"));
549 d
->setRowVisible(d
->m_sizeInfo
, d
->m_sizeVisible
);
551 quint64 totalSize
= 0;
552 foreach (const KFileItem
& item
, items
) {
553 if (!item
.isDir() && !item
.isLink()) {
554 totalSize
+= item
.size();
557 d
->m_sizeInfo
->setText(KIO::convertSize(totalSize
));
561 if (d
->m_nepomukActivated
) {
563 foreach (const KFileItem
& item
, items
) {
564 const KUrl url
= item
.nepomukUri();
570 if (d
->m_loadMetaDataThread
!= 0) {
571 disconnect(d
->m_loadMetaDataThread
, SIGNAL(finished()), this, SLOT(slotLoadingFinished()));
572 d
->m_loadMetaDataThread
->cancelAndDelete();
575 d
->m_loadMetaDataThread
= new KLoadMetaDataThread();
576 connect(d
->m_loadMetaDataThread
, SIGNAL(finished()), this, SLOT(slotLoadingFinished()));
577 d
->m_loadMetaDataThread
->load(urls
);
582 void KMetaDataWidget::setItem(const KUrl
& url
)
584 KFileItem
item(KFileItem::Unknown
, KFileItem::Unknown
, url
);
589 void KMetaDataWidget::setItems(const QList
<KUrl
>& urls
)
592 foreach (const KUrl
& url
, urls
) {
593 KFileItem
item(KFileItem::Unknown
, KFileItem::Unknown
, url
);
600 KFileItemList
KMetaDataWidget::items() const
602 return d
->m_fileItems
;
605 void KMetaDataWidget::setReadOnly(bool readOnly
)
607 d
->m_readOnly
= readOnly
;
609 // TODO: encapsulate this code as part of a metadata-model for KDE 4.5
610 if (d
->m_taggingWidget
)
611 d
->m_taggingWidget
->setReadOnly(readOnly
);
612 if (d
->m_commentWidget
)
613 d
->m_commentWidget
->setReadOnly(readOnly
);
617 bool KMetaDataWidget::isReadOnly() const
619 return d
->m_readOnly
;
622 void KMetaDataWidget::setVisibleDataTypes(MetaDataTypes data
)
624 d
->m_visibleDataTypes
= data
;
625 d
->updateRowsVisibility();
628 KMetaDataWidget::MetaDataTypes
KMetaDataWidget::visibleDataTypes() const
630 return d
->m_visibleDataTypes
;
633 QSize
KMetaDataWidget::sizeHint() const
635 const int fixedWidth
= 200;
637 int height
= d
->m_gridLayout
->margin() * 2 +
638 d
->m_gridLayout
->spacing() * (d
->m_rows
.count() - 1);
640 foreach (const Private::Row
& row
, d
->m_rows
) {
641 if (row
.infoWidget
!= 0) {
642 int rowHeight
= row
.infoWidget
->heightForWidth(fixedWidth
/ 2);
643 if (rowHeight
<= 0) {
644 rowHeight
= row
.infoWidget
->sizeHint().height();
650 return QSize(fixedWidth
, height
);
653 bool KMetaDataWidget::event(QEvent
* event
)
655 if (event
->type() == QEvent::Polish
) {
656 // The adding of rows is not done in the constructor. This allows the
657 // client of KMetaDataWidget to set a proper foreground role which
658 // will be respected by the rows.
660 d
->addRow(new QLabel(i18nc("@label", "Type:"), this), d
->m_typeInfo
);
661 d
->addRow(d
->m_sizeLabel
, d
->m_sizeInfo
);
662 d
->addRow(new QLabel(i18nc("@label", "Modified:"), this), d
->m_modifiedInfo
);
663 d
->addRow(new QLabel(i18nc("@label", "Owner:"), this), d
->m_ownerInfo
);
664 d
->addRow(new QLabel(i18nc("@label", "Permissions:"), this), d
->m_permissionsInfo
);
667 if (d
->m_nepomukActivated
) {
668 d
->addRow(new QLabel(i18nc("@label", "Rating:"), this), d
->m_ratingWidget
);
669 d
->addRow(new QLabel(i18nc("@label", "Tags:"), this), d
->m_taggingWidget
);
670 d
->addRow(new QLabel(i18nc("@label", "Comment:"), this), d
->m_commentWidget
);
674 d
->updateRowsVisibility();
677 return QWidget::event(event
);
680 #include "kmetadatawidget.moc"