forked from redomino/redomino.advancedkeyword
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
159 lines (103 loc) · 5.09 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
Index
-----
.. toctree::
:maxdepth: 2
redomino.advancedkeyword
========================
The ``redomino.advancedkeyword`` plugin aims to improve the keyword mechanism provided by Plone introducing *hierarchy* among keywords.
All the customizations introduced by redomino.advancedkeyword are made with backward compatibility in mind.
You can also use this plugin without pain when you need to migrate your contents: redomino.advancedkeyword still uses the standard ``subject`` field and the main work was made at frontend level
using javascript.
Note: You can use redomino.advancedkeyword also without having javascript enabled.
What are the main problems of the old keyword management?
---------------------------------------------------------
Here is a list of problems:
* all the keywords are listed as a long long plain list
* keywords are not semantically grouped
Here you can see the standard keyword widget how it is prompted to :
.. figure:: resources/keywordold.png
:align: center
Old keywords widgets.
As you can imagine the above edit widget is hard to use and difficult to manage.
How can advancedkeyword help you
--------------------------------
And now the advanced keyword widget with hierarchical management:
.. figure:: resources/keywordtree.png
:align: center
Keywords widget powered by redomino.advancedkeyword
The above image let the keyword editor to collapse/expand semantic groups of keywords and it is more indicated to manage large
sets of keywords as you can find in a large intranet.
You can also search for existing keywords through the existing tags.
How it works?
=============
Hierarchy is introduced using the ``.`` (dot) character: it will be used as a keyword separator.
Why we are using the dot character and not another one? Because it is little used in keywords and it is easy to type.
Edit view
---------
If you use correctly the . separator you will be able to construct a keyword tree similar to the following one:
::
[+] what [v]
[+] what.doors [v]
[+] what.doors.flat
[+] what.doors.profiled
[+] what.furniture
[-] technology [v]
...
Clicking on the collapse or expand controls you can open or close keyword nodes.
If you click on a keyword that is a leaf, all its parents will be selected automatically; if you unselect a node, all the sub keywords selected are automatically unselected.
So the keyword editor will be able to select leafs or internal nodes.
You can add new keywords using the standard Plone control: nothing has changed. If you want to add one or more keywords type something of similar:
* what.furniture.outdoor
* etc
How keywords are shown on tagged contents
-----------------------------------------
If you choose the following keywords on a particular object:
* what.doors.flat
* technology.combined systems
The customized keywords viewlet will prompt the following links:
* what (clicking on this item you will be able to see all the products)
* what.doors (clicking on this item you will be able to see all the door related products)
* what.doors.flat (clicking on this item you will be able all the flat doors related products)
* technology
* technology.combined systems
This works because we provide a customized catalog indexer for keywords.
In next releases will be provided a mechanism for changing the shown keywords (useful for example if you don't like to show "technology.combinened systems").
How to use advancedkeyword on an existing site
----------------------------------------------
At first you will see the javascript plugin with a plain keywords list, you should add the hierarchy level grouping them with dots characters: the Plone plugin named KeywordManager is you friend!
Other features
==============
Keyword map
-----------
You can see the keywords map in order to see the site arguments structure.
How to see the arguments map of the site:
* portal_url/@@keywordsmap
Keywords portlet
----------------
This product adds a new portlet: Keyword Portlet. In order to assign a new
instance of this portlet you will have to choose a "supertag" (or a namespace
tag). This supertag will be used to browse a list of all tags that are "first
child" of this tag. For ex. if your portal has these two contents::
>>> doc1.Subjects()
['supertag','supertag1','supertag.subtag1','supertag1.subtag2']
>>> doc2.Subjects()
['supertag','supertag1','supertag.subtag3','supertag1.subtag4']
and if you choose 'supertag1' as parent tag, the results list will show this:
* subtag2
* subtag4
These are link to the search page with a search parameter set to
'supertag.subtagX'.
Here you can see the keyword portlet:
.. figure:: resources/keywordportlet.png
:align: center
Keywords portlet powered by redomino.advancedkeyword (it shows a subset of existing keywords)
How to launch tests
===================
Type the following command:
::
$ ./bin/test -m redomino.advancedkeyword
Authors
=======
* Davide Moro (davidemoro) <[email protected]> (idea, concept, design and implementation)
* Giacomo Spettoli <[email protected]>
* Maurizio Lupo (sithmel) <[email protected]>