Go to main content

Textpattern CMS support forum

You are not logged in. Register | Login | Help

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

woof
Member
Registered: 2004-08-01
Posts: 128

Re: Multidoc: multiple-page documents

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)

Offline

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

jsoo
Plugin Author
From: NC, USA
Registered: 2004-11-15
Posts: 1,793
Website

Re: Multidoc: multiple-page documents

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


Code is topiary

Offline

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

jsoo
Plugin Author
From: NC, USA
Registered: 2004-11-15
Posts: 1,793
Website

Re: Multidoc: multiple-page documents

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)


Code is topiary

Offline

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

Timid&friendly
Member
From: The Netherlands
Registered: 2006-05-28
Posts: 252
Website

Re: Multidoc: multiple-page documents

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?


I think, therefore I AM, … … er … I think :-?

Offline

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

jsoo
Plugin Author
From: NC, USA
Registered: 2004-11-15
Posts: 1,793
Website

Re: Multidoc: multiple-page documents

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):

Multidoc | Contents | Up | Prev | Next | Download | Support | License

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.


Code is topiary

Offline

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

Timid&friendly
Member
From: The Netherlands
Registered: 2006-05-28
Posts: 252
Website

Re: Multidoc: multiple-page documents

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


I think, therefore I AM, … … er … I think :-?

Offline

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

jsoo
Plugin Author
From: NC, USA
Registered: 2004-11-15
Posts: 1,793
Website

Re: Multidoc: multiple-page documents

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:

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


Code is topiary

Offline

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

jsoo
Plugin Author
From: NC, USA
Registered: 2004-11-15
Posts: 1,793
Website

Re: Multidoc: multiple-page documents

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


Code is topiary

Offline

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

woof
Member
Registered: 2004-08-01
Posts: 128

Re: Multidoc: multiple-page documents

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

Offline

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

maverick
Member
From: Southeastern Michigan, USA
Registered: 2005-01-14
Posts: 976
Website

Re: Multidoc: multiple-page documents

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

Offline

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

jsoo
Plugin Author
From: NC, USA
Registered: 2004-11-15
Posts: 1,793
Website

Re: Multidoc: multiple-page documents

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)


Code is topiary

Offline

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

maverick
Member
From: Southeastern Michigan, USA
Registered: 2005-01-14
Posts: 976
Website

Re: Multidoc: multiple-page documents

thanks!

Offline

Board footer

Powered by FluxBB