Dispute

Description

The Dispute maintains a tree of information knots, consisting basically of a title and of an intrinsic textual html information. Optionally, the display supplements a knot statistics - the creation time, the author and the count of subsequent knots - as well as a set of function buttons.

The rich layout options enable a versatile usage. Originally, the Dispute was intended as a discussion platform. Then, it was adapted for documentation purposes (like this one) and as an application help system. And it suits well as a dynamic knowledge base system.

How to administrate:

  1. Purchase Dispute Package
  2. Install Dispute package
  3. Create Dispute Menu, Create Dispute Module or Add Dispute to an Article
  4. Manage Disputes
  5. Setup Dispute
  6. Inject the Dispute Hotspots Module
  7. Download / Upload Dispute

How to use:

  1. Item control elements
  2. Post your Response

Dispute Layout

Posting Title TagThe HTML tag the Posting Title is displayed in. Default is "div".

Show Item Header Show Posting information in Item Header
Show Statistics If Show Item Header set, displays count of Posting threads, count of Postings and count of authors in subordinate items
Show Buttons If Show Item Header set, displays item control buttons (see Item control elements)
Dispute Title Tag The HTML tag the Dispute Title is displayed in. One of "h1", "h2", "h3" or "div".
Dispute Title Class If the Dispute Title Tag is set to "div", you can set its CSS class. Default is "article-title".
Posting Title Tag The HTML tag the Posting Titles are displayed in. Default is "div".
Posting Title Class The Posting Title Tag's CSS class. Default is "article-title".
Postings on Page Maximum threads displayed in each level. If there are more threads, pagination occurs.
Expand Level Level to which Postings on initial page will be expanded. A value of 0 means that only headers of threading Postings are initially displayed.
Order elements by

The way Postings are ordered:

  1. Created ascending - the oldest Postings displayed first
  2. Created descending - the newest Postings displayed first
  3. Order Field - the order is defined by Postings' Order field value

Typical configurations

Using the Dispute as Discussion system, enable Item Header, Buttons and probably also Statistics. Let elements be sorted by Created - ascending with newest postings first or descending to show in the chronological order.

When using as a Documentation, Knowledge-base or Help tool, switch Item Header off (admins still see it). Order the postings by Order Field, which enables you to set it corresponding to the logical rather then to chronological structure. A good tip is to increment it by some number like 5, which enables later adaptation without renumbering all nodes concerned.

For Help systems or other cases where just one Item should be displayed without its context, there is the "single" option: set the token "task=single" in the URL query.  Probably you don't need to display the Joomla context, so add "tmpl=component" to the query. Let say, "http://myserver.com/mydisputemenu?task=single&tmpl=component&pst=358". You have to care for navigation inside the Item's text in that case (Referencing Dispute nodes).

There are also two CSS classes supporting different display in the "normal" and in the "single" mode: "single-only", displaying the HTML element in the "single" mode and hiding it in the "normal" mode, and "full-only", doing the opposite:

<div class="single-only">
  <p>Back to {ref pst881}</p>
  <p>Continue with {ref pst883}</p>
</div>

will display on "http://myserver.com/mysite?task=single", but not on "http://myserver.com/mysite". This enables e.g. using the same Dispute as a Documentation tool and as a Help system at the same time.