adi_matrix – Multi-article update tabs

gomedia · 2011-04-15 05:49:33

Summary

adi_matrix provides a way of viewing and updating multiple articles from a single TXP admin tab.

Matrixes give you a summary view of multiple articles, where you can make changes to selected data fields & update them all in one go.

See the help supplied with the plugin, or have a look online. Download the latest version from here.

adi_matrix admin tab

This is where you set up the article matrixes. There are three aspects to this:

Matrix appearance
- give the matrix a name (used to list it under the Contents tab)
- specify the order in which articles should be listed
- specify whether a single user or all users are to get access to the matrix
- specify whether access to the matrix is based on privileges or not
- matrix tab style
Article selection criteria
- by default all articles will be listed in the matrix, but you can narrow it down according to:
  - section
  - category
  - article status
  - author
  - keywords
  - posted & expires timestamps
Article data display
- where you define what data the user can see and change:
  - article status
  - custom fields
  - article image
  - keywords
  - categories
  - posted & expires timestamps

Article matrix tabs

The matrix tabs under Contents show a number of articles, with their “data”. If you are the article author or have sufficient overriding privileges then you can make changes to the data & update all articles with a single click.

Note that only articles where you have actually changed anything will be updated in the database – along with their Last Modified Date and Author.

adi_matrix respects all the standard restrictions on who can make changes to articles – based on authorship & privilege level.

Practical examples

On a real estate website, where each block of land is an article with custom fields detailing size, price & availability. When things change – land is sold, prices changed – updates are easy. Everything is in the one place:

An interesting side effect is that if you define a matrix without any data fields, you end up with a simple tab listing links to a number of articles. For example, all the Sticky articles:

Textpack

There is a mechanism to install a Textpack in the adi_matrix options page under the Plugins tab.

Currently the Textpack contains:

French (thanks Pat64 & CeBe)
Swedish (thanks Mats)
Russian (thanks the_ghost)
Spanish (thanks Jorge & gfdesign)
Italian (thanks Zanza)
German (thanks jay rope)
Japanese (thanks HJ)

Corrections or additional language translations are most welcome and can be submitted here.

Requirements

Textpattern 4.5.0 or later.

Bug & Limitations

adi_matrix updates articles, so if you are cautious – take a backup of your database before playing.
the Suhosin PHP extension can prevent adi_matrix from updating articles
input field tooltips won’t work with glz_custom_fields
the descendent categories option is disabled when category wildcards are used
don’t pick a Matrix name that clashes with an existing tab name – e.g. a matrix called “Articles” placed in Content will give you errors

Version history

2.0
- enhancement: publish & delete articles (for mrdale)
- enhancement: extra article data options: title, section
- enhancement: show sections
- enhancement: added section & author to article title tooltip
- enhancement: matrix under Content or Home tab
- enhancement: improved validation error messages
- enhancement: custom WHERE clause conditions
- enhancement: article list paging
- requires TXP 4.5+
- tested on TXP 4.6
- fix: matrix privileges
- improved validation message (URL-only titles)
- article edit link styling
1.2
- TXP 4.5-ified
- French colon-isation
- lifecycle “upgrade” pseudo-event
1.1
- code tidy up (thanks gocom)
- enhancement: matrix tab optional footer
- enhancement: matrix tab column sorting
- enhancement: “Any parent” & “Any child” category wildcards
- enhancement: posted timestamp (& reset)
- enhancement: expires timestamp
- enhancement: multi-section select (for maniqui & mrdale)
- enhancement: input field tooltips (for masa)
- for mrdale:
  - <body class=“adi_matrix”> on all matrix tabs
  - another attempt at horizontal scrolling, this time with a fixed article title column
  - more sorting options
  - TinyMCE support for glz_custom_field textareas
  - option to include descendent categories
- fixed: checkboxes again! (thanks redbot)
- changed: “Nothing to do” message changed to “No articles modified”
- changed: admin tab name/title to “Article Matrix”/“Article Matrix Admin”
1.0.1 (not officially released)
- fixed: completely unticked checkboxes not updated (thanks redbot)
- fixed: detect glz_custom_fields in plugin cache (thanks gocom)
1.0
- enhancement: glz_custom_fields compatibility
- enhancement: force numeric sort (for jpdupont)
- enhancement: sort by Expires timestamp
- enhancement: article catagories (for maniqui)
- enhancement: option to switch on horizontal scroll (for mrdale)
- fixed: MySQL 4.1 compatibility (thanks colak)
- fixed: error if custom field contains single quote (thanks maniqui)
- fixed: superfluous “Logged in user” wildcard option in matrix appearance
- now uses lifecycle events
0.3
- enhancement: “One category”, “Two categories” wildcards
- enhancement: timestamp (for CeBe)
- enhancement: expiry (for CeBe)
- enhancement: future/expired articles highlighted & preference (for CeBe)
- enhancement: article title tooltip, & preference
- admin: install/uninstall/textpack moved to plugin options
0.2
- fixed: missing child categories (thanks Zanza)
- enhancement: “No category”, “Any category” wildcards
- enhancement: “Logged in user” wildcard
- enhancement: article image field (for Zanza)
- enhancement: article limit preference (for milosevic)
0.1
- initial release

Feedback

Comments are most welcome.

Acknowledgements

Thanks go to mrdale who was very kind in sending me some beer vouchers for version 1.1.

Spread the love

If you find this plugin useful and would like a warm and fuzzy feeling to go with it, please consider donating to the Textpattern development team.

Last edited by gomedia (2017-11-13 06:09:29)

Pat64 · 2011-04-15 06:35:54

Hi Adi.

Here is a better french textpack translation:

# Textpack for adi_plugins (www.greatoceanmedia.com.au/txp)
# - English language strings bundled with plugin, all others in this textpack
# - please submit corrections/additions at www.greatoceanmedia.com.au/textpack, thanks
#@public
#@language fr-fr
adi_article_data => Données de l'article
adi_article_selection => Choix de l'article
adi_article_update_fail => La mise à jour de l'article a échoué
adi_articles_saved => Article sauvegardé
adi_display_article_id => Afficher l'article ID#
adi_install_fail => Impossible d'installer
adi_installed => Installé
adi_matrix => Matrice
adi_matrix_name => Nom de la matrice
adi_matrix_delete_fail => La suppression de la matrice a échoué
adi_matrix_deleted => Matrice supprimée
adi_matrix_update_fail => La mise à jour des paramètres de la matrice a échoué
adi_matrix_updated => Les paramètres de la matrice ont été mis à jour
adi_not_installed => Non installé
adi_nothing_to_do => Rien à faire
adi_pref_update_fail => La mise à jour des préférences a échoué
adi_textpack_fail => L'installation du fichier Textpack a échoué
adi_textpack_online => Textpack est également disponible en ligne
adi_uninstall => Désinstaller
adi_uninstall_fail => Impossible de désinstaller
adi_uninstalled => Désinstallé
adi_update_matrix => Mettre à jour les paramètres de la matrice
adi_update_prefs => Mettre à jour les préférences
adi_user => Utilisateur

This one is newer than my feedback message send from your site. Please consider that as a final translation. Tks.

Regards,

gomedia · 2011-04-15 06:40:32

Pat64 wrote:

Here is a better french textpack translation:

Thanks Patrick, much obliged. Just do an “Install Textpack” again.

Last edited by gomedia (2011-04-15 06:41:23)

Pat64 · 2011-04-15 07:19:06

gomedia wrote:

Thanks Patrick, much obliged. (…)

My pleasure. Thanks Wet for this very great textpack feature.

the_ghost · 2011-04-15 08:24:36

Sent russian textpack. Useful plugin!

pieman · 2011-04-15 08:44:08

Liking the sound of this a lot.

redbot · 2011-04-15 08:58:25

This looks very usefuful. Thanks Adi!

gomedia · 2011-04-15 10:05:58

the_ghost wrote:

Sent russian textpack. Useful plugin!

Thanks, hope so.

pieman: wrote:

Liking the sound of this a lot.

Works for me!

redbot wrote:

This looks very usefuful. Thanks Adi!

My pleasure.

And thanks to Mats for a Swedish translation.

… click the “Install Textpack” link in adi_matrix admin to download the new lingo.

uli · 2011-04-15 13:02:39

Adi, you made me laugh just out of joy! I’ve dreamt of such a thing for ages. Thanks just for this laugh! :)

renobird · 2011-04-15 13:36:49

What an amazing idea. I have a site that has 450+ articles — each with a variety of custom fields. They don’t need updated all that often (once a year), but man will this ever same some time when they do. Thanks Adi.

wornout · 2011-04-15 14:21:29

Hi Adi.
Thanks, it’s amazing! Another adi_plug in my pref list :)
Only a question. Is adi_matrix compatible with GLZ_CF and MLP?
Thanks

Last edited by wornout (2011-04-15 14:21:55)

joebaich · 2011-04-15 16:10:52

Hello Adi,

Great piece of work, taken into use immediately to make a site’s owner/user a very happy chap. Me too, of course.

Wornout: Dunno about MLP but GLZ_CF seems to work. wonderfully well.

Joe

Textpattern CMS

Textpattern CMS support forum

#1 2011-04-15 05:49:33

adi_matrix – Multi-article update tabs

#2 2011-04-15 06:35:54

Re: adi_matrix – Multi-article update tabs

#3 2011-04-15 06:40:32

Re: adi_matrix – Multi-article update tabs

#4 2011-04-15 07:19:06

Re: adi_matrix – Multi-article update tabs

#5 2011-04-15 08:24:36

Re: adi_matrix – Multi-article update tabs

#6 2011-04-15 08:44:08

Re: adi_matrix – Multi-article update tabs

#7 2011-04-15 08:58:25

Re: adi_matrix – Multi-article update tabs

#8 2011-04-15 10:05:58

Re: adi_matrix – Multi-article update tabs

#9 2011-04-15 13:02:39

Re: adi_matrix – Multi-article update tabs

#10 2011-04-15 13:36:49

Re: adi_matrix – Multi-article update tabs

#11 2011-04-15 14:21:29

Re: adi_matrix – Multi-article update tabs

#12 2011-04-15 16:10:52

Re: adi_matrix – Multi-article update tabs

Board footer