-
Notifications
You must be signed in to change notification settings - Fork 3
/
README.txt
212 lines (154 loc) · 5.79 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
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
/**
* @file
* README file for Workbench.
*/
Workbench
A framework for simplified content management.
CONTENTS
--------
1. Introduction
1.1 Use-case
1.2 Examples
1.3 Terminology
2. Installation
3. Permissions
4. Configuration
5. Using the module
5.1 My Content
5.2 Create Content
6. Troubleshooting
7. Developer notes
7.1 API documentation
7.2 Database schema
7.3 Views integration
8. Feature roadmap
----
1. Introduction
Workbench provides a simplified user interface and an API to integrate other
Drupal modules. Workbench on its own provides Content contributors a way to
easily access their own content.
Workbench gains more features when you install and enable these modules:
Workbench Access - http://drupal.org/project/workbench_access
Workbench Moderation - http://drupal.org/project/workbench_moderation
Workbench Media - http://drupal.org/project/workbench_media
Workbench Files - http://drupal.org/project/workbench_files
One way to think about Workbench is that it becomes the Dashboard for Content
Contributors. Basically, putting all of the content needs of a user in one
place.
----
1.1 Use Case
Drupal provides a great framework for building functionality. Workbench helps
harness content-focused features in one unified user interface. The goal
is that a user does not need to learn Drupal in order to add content to the
site.
Users need access to their account, their content, and to add new content.
Instead of having to know how to navigate to My Account (/user/[uid]),
Add content (node/add), and Find Content (admin/content), the user goes to
My Workbench instead.
Simple changes like this help ease the learning curve for new users.
With additional Workbench modules like Workbench Access and Workbench
Moderation, Workbench becomes a full system which controls who can access
content and provide editorial workflow so that only the correct content is
published.
----
2. Installation
Views is required in order to install Workbench.
Install the module and enable it according to Drupal standards.
----
3. Permissions
Once a user role has access to create content, Workbench becomes
immediately useful.
Workbench Permissions
-- Administer Workbench settings
Only Administrators should have access to this. Workbench without its other
modules does not have any configuration settings. It becomes more useful
when additional workbench modules are enabled.
-- Access My Workbench
For any user role who may access their own workbench a.k.a My Workbench
-- View all unpublished content
Allows a user to see content that is not Published on the site. This
becomes even more useful when Workbench Moderation is enabled.
A typical permission setup so that a user can take advantage of Workbench
looks like:
Node Permissions
-- Article: Create new content
-- Article: Edit own content
-- Article: Delete own content
-- Basic page: Create new content
-- Basic page: Edit own content
-- Basic page: Delete own content
System Permissions
-- View the administration theme
Toolbar Permissions
-- Use the administration toolbar
Workbench Permissions
-- Access My Workbench
----
4. Configuration
Workbench does not have any Configuration settings. Additional Workbench
modules have their own configuration.
----
5. Using the module
As an Administrator or a user with Access My Workbench permissions, you will
see My Workbench in the toolbar to the right of the Home icon.
----
5.1 My Content
On the My Content tab, you can see three areas:
- My Profile
- Content I've Edited
- All Recent Content
This is your content dashboard. As soon as you Add or edit content, it will
be displayed in the Content I've Edited block.
Notice the sub tabs:
- Content I've Edited
- All Recent Content
These go to full page lists with filters available to shorten the list of
content. You can filter the list by:
- Title (keywords)
- Type (Content type)
- Published (status of the content)
- Items per page (defaults to 25)
Any lists of content include columns labels which can sort the current list.
Each item in the list links to the full content or you can click edit to
start editing.
----
5.2 Create Content
Click the Create Content tab to view a list of types of content that you can
create. Remember, we're dealing with Entities now. Initially, Workbench
shows various Node Types that you have permission to create. When
Workbench Media is enabled, the Media item is added to this list as well.
Click the type of content you want to add, then follow the usual procedure for
adding content.
----
6. Troubleshooting
Some helpful tips.
For automatic navigation to Workbench, be sure to give your user role
access to the Administration Toolbar; otherwise you need to add access to
one of the menus.
Be sure your user role has permission to create content. Without those
permissions, Workbench will only give you access to your user account.
----
7. Developer notes
The following section documents technical details of interest to developers.
----
7.1 API documentation
Workbench does not offer a generic API. Please check the other
Workbench modules like Workbench Access for descriptions of their APIs.
----
7.2 Database schema
Workbench does not create any tables during installation. Other Workbench
modules like Workbench Access and Workbench Moderation create tables.
Please review each module's README.txt file to learn more about schema
changes.
----
7.3 Views integration
Workbench creates several base views for the My Content tab. Other
Workbench modules further alter these views. You can alter the views
via Views UI as well.
----
8. Feature roadmap
-- integrate workflow module as an alternative to workbench_moderation
-- publish permissions per content type
-- email notifications
-- integrate scheduler module for scheduled start/end publish dates
-- general UX improvements