Multidoc: multiple-page documents

woof · 2010-01-27 21:39:04

Hi Jeff, I’m back giving this plugin another workout

One thing I’ve noticed with <txp:soo_multidoc_toc /> is that it seems to include pages regardless of their article status, so should an editor change a multidoc article’s status (e.g. to hidden or draft) its title/link will still show in the toc even though the page is now inaccessible.

Is there any way around this? — ie to output only pages whose status is live?

Last edited by woof (2010-01-27 21:39:50)

jsoo · 2010-01-27 22:17:08

Very good point I hadn’t thought of. Thinking cap on …

jsoo · 2010-01-28 02:52:55

Version 1.0.b.3 now available

(requires updated version of soo_txp_obj, available on the download page)

Articles without live or sticky status now excluded
Expired articles now excluded or not, according to site preference
New preference for showing past, future, or all articles

Thanks to woof for the suggestion.

Downloads.

Note:

Though a small change in terms of edited code, it does alter the initialization routine at the heart of Multidoc. It has been tested, but not extensively tested.

Last edited by jsoo (2010-01-28 12:04:59)

Timid&friendly · 2010-06-07 20:24:41

Hi,

I’ve been fiddeling with the plugin and getting nowhere really really fast. It’s probably me being dim but i when i use it pages disappear.

Would it be possible to see a whole txp section-page, with individual_article and couple of necessary forms, so i can see the context within which you use your fancy multdoc tags?

jsoo · 2010-06-07 21:19:31

You’re not dim :) It’s not the world’s most intuitive plugin. If you are getting unexpected results, check to see if Multidoc is providing any useful error messages.

The only site on which I currently use it is my personal site. Page template is nothing out of the ordinary, just a normal article tag.

Relevant bits of my default article form:

<txp:if_article_list>
    <!-- standard Txp tags for article list formatting -->
<txp:else />
<txp:soo_if_multidoc><txp:output_form form="soo_multidoc_header" /></txp:soo_if_multidoc>
    <!-- standard Txp tags for individual article formatting -->
<txp:soo_if_multidoc><txp:output_form form="soo_multidoc" /></txp:soo_if_multidoc>
</txp:if_article_list>

The soo_multidoc_header form looks like this:

<p id="soo_multidoc_header"><txp:soo_multidoc_link rel="start" add_title="1" /> <txp:soo_multidoc_page_number /> <span id="arrows"><txp:soo_multidoc_link rel="prev">&laquo;</txp:soo_multidoc_link> <txp:soo_multidoc_link rel="next">&raquo;</txp:soo_multidoc_link></span></p>

It makes a header that looks like this:

Multidoc Page 5 of 26 « »

The soo_multidoc form looks like this:

<ul id="soo_multidoc_prev_next"><txp:soo_multidoc_link rel="Start" add_title="1" wraptag="li" /><txp:soo_multidoc_link rel="Contents" wraptag="li" /><txp:soo_multidoc_link rel="Up" wraptag="li" /><txp:soo_multidoc_link rel="Prev" wraptag="li" /><txp:soo_multidoc_link rel="Next" wraptag="li" /><txp:soo_multidoc_link rel="Download" wraptag="li" /><txp:soo_multidoc_link rel="Help" wraptag="li">Support</txp:soo_multidoc_link><txp:soo_multidoc_link rel="Copyright" wraptag="li">License</txp:soo_multidoc_link>
</ul>

It makes a footer that looks like this (all links, actual anchor tags omitted for this example):

So that header and footer appear automatically for any individual article view of a Multidoc article.

Perhaps the tricky part is correctly managing the Multidoc custom field. Here’s the value for the start page of my Multidoc user manual:

Contents 33,Section 31 34 30,Help 43,Copyright 29

because article #33 is the table of contents, articles 31, 34, and 30 are “chapter” header pages, and so on.

It’s also possible to use Multidoc tags directly in article bodies, as I do at various point throughout the support article.

Timid&friendly · 2010-06-09 05:57:28

Thx very much. I’ll take a good look and test everything when i get a mo this week. BTW I was getting no multidoc error messages

jsoo · 2010-09-13 00:56:45

Major upgrade now available. Tags and public-side functionality are basically unchanged (although page rendering should generally be faster). But the back end has been substantially redone.

Main new feature is a new admin panel, making document management much easier and less error-prone.

If you are upgrading from Multidoc version 1 please read the upgrade instructions carefully.

Multidoc 2

If you’re new to Multidoc I suggest following the above link and looking through the entire guide — it’s pretty quick.

If you’re familiar with Multidoc version 1, the main things to check out are:

http://ipsedixit.net/txp/39/easy-document-management for a look at the admin panel
http://ipsedixit.net/txp/27/installation-and-requirements for upgrade instructions

Last edited by jsoo (2010-09-14 15:12:50)

jsoo · 2010-09-14 13:35:41

Minor bugfix release today (version 2.0.b.2). One particular article arrangement was triggering a recursion error.

woof · 2010-09-14 13:40:21

This looks like a fantastic upgrade with the admin panel, can’t wait to try it out. Thanks!

maverick · 2010-09-14 14:30:13

Jeff

Is the soo_multidoc_admin version 0.1 download link broken?

I’m getting a generic type page instead of a download

Thanks
Mike

jsoo · 2010-09-14 15:04:48

maverick wrote:

Is the soo_multidoc_admin version 0.1 download link broken?

Sorry about that; I forgot to enable it in my rah_plugin_download settings.

Download soo_multidoc_admin.

Please don’t install before looking over the install/upgrade instructions.

Last edited by jsoo (2010-09-14 15:14:44)

maverick · 2010-09-14 15:31:48

thanks!

Textpattern CMS

Textpattern CMS support forum

#25 2010-01-27 21:39:04

Re: Multidoc: multiple-page documents

#26 2010-01-27 22:17:08

Re: Multidoc: multiple-page documents

#27 2010-01-28 02:52:55

Re: Multidoc: multiple-page documents

#28 2010-06-07 20:24:41

Re: Multidoc: multiple-page documents

#29 2010-06-07 21:19:31

Re: Multidoc: multiple-page documents

#30 2010-06-09 05:57:28

Re: Multidoc: multiple-page documents

#31 2010-09-13 00:56:45

Re: Multidoc: multiple-page documents

#32 2010-09-14 13:35:41

Re: Multidoc: multiple-page documents

#33 2010-09-14 13:40:21

Re: Multidoc: multiple-page documents

#34 2010-09-14 14:30:13

Re: Multidoc: multiple-page documents

#35 2010-09-14 15:04:48

Re: Multidoc: multiple-page documents

#36 2010-09-14 15:31:48

Re: Multidoc: multiple-page documents

Board footer