15 - File Manager

Submitted by ErichSteinboeck

This package will help you set up a List by Category File Manager featuring

• a combined listing of normal and hidden pages by category and by creation date
• quick-edit link icons allow directly editing a page without first rendering it
• page viewing without following any redirect (uses noredirect/true)
• a page count of displayed pages — normal pages and hidden pages
• a sort (either either ascending or descending) function: by page name, by edit date, or by creation date
• a simple method to add categories to the list

Content

The package consists of the following pages — all in category list:

1. A set of five pages providing the core File Manager functionality
   • list:_template — the “File Manager” Live Template; it includes the following four pages
   • list:_include-header — the “List by Category” header; may be customized (e. g. translated into a different language)
   • list:_include-pages — the ListPages front-end; may be customized to change defaults
   • list:_include-pages-template — the ListPages core code; no customization expected
   • list:_include-pages-prepend — the ListPages core code prepend helper include; no customization expected
     
     
2. A starter set of category pages for categories that exist for most Wikis
   • list:default — List pages with no category
   • list:all — List pages from all categories
   • list:admin — List by category “admin”
   • list:forum — List by category “forum”
   • list:include — List by category “include”
   • list:list — List by category “list”
   • list:nav — List by category “nav”
   • list:search — List by category “search”
   • list:system — List by category “system”
   • list:template — List by category “template”

Real Life Example

You may find working File Manager examples on

• Wikidot Community and
• Wikidot Sandbox.

How to Use

To install the package page to your Wiki, you may either

• use the Package Installer, or
• manually copy the pages.

After installing the package using either of the above methods, a tag “_ignore” must be added to the following pages:

• list:all
• list:default

Package Installer

To use the Package Installer enter the name of your Wiki below and click on “Install.”

Manual Installation

If you'd like to manually copy the pages, follow these steps for each of the pages listed below.

• click the page name to show the source code,
• create a page of the same name on your Wiki,
• copy & paste the page title and the page code to your page, and
• press Ctrl+S (Save)

Core Pages

list:_template »

Page title: List by Category: Template

[[include list:_include-header |
%%content{1}%% |
category=%%page_name%% |
]]
[[include list:_include-pages |
%%content{1}%% |
category=%%page_name%% |
page=%%page_unix_name%% |
]]

list:_include-header »

Page title: List by Category: Include Header

[[div style="font-size:80%; float:right; width:auto; padding:0 0 0 0.5em"]]
Only list pages
created in:
[[module PageCalendar category="{$category}"]]
[[/div]]
[[div style="float:right;width:19em"]]
[[div style="float:right;width:1em; margin-right:2em"]]
@@@@[[footnote]]
**How to Add or Remove a Category to/from the List**
* To **add a category** to the list of displayed categories,
 * type the category name and click on ``Add category'',
 * wait until the editor opens,
 * type ``List by Category: '' plus the category name into the ``Title of the page'' field, and
 * press Ctrl+S (Save).

* To **add a category,** whose name has a **leading underscore** (``_''),
 * type the category name without the underscore and click on ``Add category'',
 * wait until the editor opens,
 * type ``List by Category: '' plus the category name into the ``Title of the page'' field, and
 * type {{category=_//category-name//}} as the page content, and
 * press Ctrl+S (Save).

* To **remove a category** from the list of displayed categories, delete the page ``list://category-name.//''
[[size xx-small]]
File Manager Change History:
V1.1 20090905 now also lists/counts hidden files; created missing list:_include-pages-prepend
[[/size]]
[[/footnote]]
[[div style="display : none;"]]
[[footnoteblock title=""]]
[[/div]]
[[/div]]
[[module NewPage category="list" size="10" button="Add category" format="/^_?[-a-zA-Z0-9]*$/"]]
[[/div]]
[[module ListPages category="list" tags="-_ignore" separate="no" order="titleAsc" perPage="999"
prependLine="List all pages
* with [[[list:default|no category]]][!----]
* from category \"
appendLine="or
* from [[[list:all|all categories]]]"
]]
[[[%%page_unix_name%%]]], \
[[/module]]

[[size smaller]]//Note:// If you select a //category//, sorting will work fine; if you select a //creation date//, sorting will remove the //creation date// filter and display the full category.[[/size]]

list:_include-pages »

Page title: List by Category: Include Pages

 [[include list:_include-pages-template
heading={$heading} | heading=++ Category ``{$category}'' |
anchor={$anchor} | anchor={$category} |
category={$category} | category=_default |
page={$page} | page=system:list-pages |
perPage={$perPage} | perPage={$limit} |
limit={$limit} | limit=10000 |
size={$size} | size=85% |
attributes={$attributes} | attributes=order="@URL" date="@URL" pagetype="*" |
styleT={$styleT} | styleT=padding-right:0.5em |
styleE={$styleE} | styleE=text-align:right; padding-right:0.5em; width:12.7em |
styleC={$styleC} | styleC=text-align:right; width:12.7em |
urlView={$urlView} | urlView=[/%%page_unix_name%%/noredirect/true %%title%%] |
urlEdit={$urlEdit} | urlEdit=[image http://packages.wikidot.com/local--files/package:15/view-source14x14.png alt="(edit)" link="/%%page_unix_name%%/edit/true/norender/true/noredirect/true" style="vertical-align:middle"]
]]

list:_include-pages-template »

Page title: List by Category: Include Pages Template

[[table]][[row]][[cell]]
{$heading}[[# A_{$anchor}]]
[[/cell]][[cell]]
[[module CountPages category="{$category}" date="@URL" pagetype="*" module_body="(%%count%% pages displayed --"]]
[[/cell]][[cell]]
[[module CountPages category="{$category}" date="@URL" pagetype="normal" module_body="%%count%% normal,"]]
[[/cell]][[cell]]
[[module CountPages category="{$category}" date="@URL" pagetype="hidden" module_body="%%count%% hidden)"]]
[[/cell]][[/row]][[/table]]
[[size {$size}]]
[[module ListPages category="{$category}" perPage="{$perPage}" limit="{$limit}"
separate="false" {$attributes}
prependLine="[[include list:_include-pages-prepend page={$page} | anchor={$anchor} | styleT={$styleT} | styleE={$styleE} | styleC={$styleC}]]"
appendLine="[[/table]]"
]]
[[row]][[cell style="{$styleT}"]][{$urlEdit}] {$urlView}[[/cell]][[cell style="{$styleE}"]]%%date_edited|%e %b %Y, %R%%[[/cell]][[cell style="{$styleC}"]]%%date|%e %b %Y, %R%%[[/cell]][[/row]]
[[/module]]
[[/size]]

list:_include-pages-prepend »

Page title: List by Category: Include Pages Prepend

[[table]][[row]][[cell style="{$styleT}"]]//Page Name//[[/cell]][[cell style="{$styleE}"]]//Last Edited//[[/cell]][[cell style="{$styleC}"]]//Date Created//[[/cell]][[/row]][[row]][[cell style="{$styleT}"]][[size 80%]]Sort [/{$page}/order/titleAsc#A_{$anchor} ascending]/[/{$page}/order/titleDesc#A_{$anchor} descending][[/size]][[/cell]][[cell style="{$styleE}"]][[size 80%]]Sort [/{$page}/order/dateEditedDesc#A_{$anchor} newest first]/[/{$page}/order/dateEditedAsc#A_{$anchor} oldest first][[/size]][[/cell]][[cell style="{$styleC}"]][[size 80%]]Sort [/{$page}/order/dateCreatedDesc#A_{$anchor} newest first]/[/{$page}/order/dateCreatedAsc#A_{$anchor} oldest first][[/size]][[/cell]][[/row]]

Category Pages

list:default »

Page title: List by Category: No Category
Tags: _ignore

heading=++ Pages without Category | category=_default

list:all »

Page title: List by Category: All Categories
Tags: _ignore

heading=++ All Categories | category=* | anchor=all

list:admin, list:forum, list:include, list:list, list:nav, list:search, list:system, list:template »

Page title: List by Category: category-name
No page content

Optional Steps

Edit Icon

If you copy the File Manager code to your Wiki, the link to the edit icon is http://packages.wikidot.com/local--files/package:15/view-source14x14.png. If you'd like to remove this dependency on another Wiki, download the icon from this page, attach it to list:_include-pages, and change the the [[image …]] reference in list:_include-pages to [[image list:_include-pages/view-source14x14.png …]

Shortcut

You may optionally want to create a set of pages named “_” (underscore) in each category (that is category-name:_) with below page content to enable convenient and easy-to-remember shortcuts to the “List by Category” pages.

Page: category-name:_

[[module Redirect destination="list:category-name"]]

Change History

V1.1 20090905

list:_include-header: Added change history V1.1
list:_include-pages: Added pagetype="*"
list:_include-pages-template: changed include:list-pages-prepend to list:_include-pages-prepend; added triple CountPages code
list:_include-pages-prepend: created

gerdami 28 Aug 2009 17:48

With this stuff, there is a risk that Pieter would put you again on the hall of fame ! :)

---

gerdami - Visit Handbook en Français - Rate this howto:import-simple-excel-tables-into-wikidot up!

Missing File

Sue Firth 04 Sep 2009 12:11

When I installed this package using the Package Installer above, there was a file missing from my site (include:list-pages-prepend).

I found what I hope to be a suitable version of this file at http://community.wikidot.com/include:list-pages-prepend and copied it from the community website to mine. I then added a new menu item to my site using:

* [/list:default Files]

to launch the File Manager and it now seems to work.¹ I hope this helps the next person.

Erich, thanks for writing this brilliant utility. It's very useful and I wouldn't have been able to do it myself. :)

Footnotes

1. Erich, please let me know if this was the wrong file to use. Thanks.

Missing File

ErichSteinboeck 05 Sep 2009 14:35

Sue, thanks for pointing out this error. You've used the right file to correct the problem.

I've updated the File Manager package to version 1.1 —

• It now contains the missing list:_include-pages-prepend (I've changed the name from include:list-pages-prepend to keep everything neatly in a single category)
• File Manager now also lists and counts hidden pages (using the newly introduced pagetype="…" attribute)
• A change history in the "Add category" footnote will now let you know which version of File manager you've installed
• I've updated the File Manager installations on Community and Sandbox to the latest version

You might also want to re-install File Manager to pick up the newest version (after installing it you may delete include:list-pages-prepend as it will not be used any more).

Last edited on 05 Sep 2009 16:42 by ErichSteinboeck Show more

V1.1

Sue Firth 05 Sep 2009 17:46

Erich, I've applied your updates to my site and, I must say, I love it even more now that it lists the hidden pages too!

Thank you very much. Sue :)

Using the File Manager in Iron Giant

pieterh 10 Sep 2009 08:20

Erich, I'd like to use this in some of the template sites. Would you join the http://forum.wikidot.com (as watcher) so we can discuss this?

---

Portfolio

Re: Using the File Manager in Iron Giant

ErichSteinboeck 10 Sep 2009 20:29

Sure — amongst others I'm also tracking http://forum.wikidot.com via RSS

An automated list of categories?

scottplan 15 Mar 2010 13:46

This would be even better if there were some way to automate the category list. Maybe this would be a solution?

http://blog.wikidot.com/weneed:210

Post preview:

Close preview

	or Sign in as Wikidot user
	(will not be published)

- +

Help: wiki text quick reference

Edit | Tags | Source | Print

Who's watching this?

pieterh
gerdami
Vittek
avokado
MRichrath
suef
Divan
ValAeryn
RobElliott
Wayne Hildreth
arbitrage
rosemb
DWK25
leiger
Peter-ZA
Arotaritei Vlad
nagamii
Drbmusic
appliquetion
BRANDONBYRONBRITTON

Watch: site | category | page

Packages

18 - Slim Chatroom (21 Nov 2009 04:20) [+2, ]
17 - James' Chatroom (18 Nov 2009 10:23) [+1, ]
16 - Minimal Editor CSS (31 Aug 2009 12:45) [+0, ]
15 - File Manager (28 Aug 2009 16:15) [+5, ]
14 - Debugger (16 Aug 2009 07:52) [+0, ]
13 - Custom Forum (15 Aug 2009 10:56) [+1, ]
12 - Image Include (02 Aug 2009 20:51) [+3, image include infobox picture]
11 - User profile & badges (27 Jul 2009 07:25) [+1, badge profiles user]
10 - Voting poll (26 Jul 2009 13:41) [+1, poll vote]
9 - Multilingual website (05 Jul 2009 10:49) [+2, handbook multilingual]
8 - Photo Gallery (28 Jun 2009 19:41) [+3, 1col gallery images photo]
7 - Squark's Blog (22 May 2009 12:06) [+4, 1col blog]
6 - Multilanguage petition (01 May 2009 13:50) [+1, 2col multilingual]
5 - News & comments (29 Apr 2009 08:44) [+1, 2col blog]
4 - Chatter category (28 Apr 2009 15:06) [+1, 2col]
3 - Simple issue tracker (28 Apr 2009 14:58) [+3, 2col tracker]
2 - Wiki category (28 Apr 2009 14:49) [+1, 2col]
1 - Legal framework (28 Apr 2009 14:33) [+2, 2col]