File: update-1.6.0.txt

package info (click to toggle)
mydms 1.7.0-1%2Blenny1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 1,844 kB
  • ctags: 2,452
  • sloc: php: 17,707; sql: 281; sh: 47; makefile: 47
file content (141 lines) | stat: -rw-r--r-- 5,291 bytes parent folder | download
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
-------------------------------------------------------------------
              MyDMS 1.6.0 Update from previous Version
-------------------------------------------------------------------

IMPORTANT: Backup your database before commencing any upgrade.


1. Requirements

You must have version 1.5.1 of MyDMS installed and configured correctly on
your system.

IMPORTANT: Backup your database before commencing any upgrade.

To upgrade from a version of MyDMS older than 1.5.1, first follow the
instructions found in the document "update-1.5.0.txt".


2. Updating the Database

IMPORTANT: Backup your database before commencing any upgrade. (Can I make
this any plainer?)

Run the script "update_tables-1.6.0.sql" from within your MySQL client, ensuring
that the correct datbase has been created.


3. Creating the Document Status Index

MyDMS uses a new document lifecycle management system that allows users to
review and approve documents. In order to manage this system, new database
tables have been introduced to record status, and the main status table needs
to be pre-populated before any upgraded installation can be used. If you do
not carry out this step, documents will not appear when browsing folders (the
files are still in MyDMS but the new report relies on content from
tblDocumentStatus and tblDocumentStatusLog and will silently fail if these
tables are incomplete.).

To populate the status tables, open a web browser window and log into MyDMS
as an Administrative user. Then load the following page:

http://${server}/${mydms root}/op/op.CreateStatusIndex.php

This script will only run if the user has administrative privileges. Even so,
I recommend that the file is deleted after it has been run and you have
verified that MyDMS is running correctly. The script need only be run once.
This page can only be accessed directly -- there are no links within MyDMS
that take to you this page.


4. New Page Layout and Styles

The user interface for MyDMS has been completely revised and updated,
replacing the original theme engine. MyDMS uses CSS style sheets to manage
all aspects of page layout, including the colour scheme. Stylesheets and
supporting files such as images are stored in the styles directory. As of
1.6.0, the default MyDMS style is called "orange". If you would like to
create your own styles, make a copy of the "orange" directory and begin
experimenting.

The user interface has been split into 4 basic container types:

	Global Navigation
		Contains the name of the site, global navigation bar, quick search box
		and the name of the current user.

		<!-- Outer element. Displays the background gradient. -->
		<div class="globalBox">
			<!-- Displays the top right corner. Can also be used to render a logo. -->
			<div class="globalTR"></div>
			<!-- The global navigation bar -->
			<ul class="globalNav">
				<li id="first">...</li>
				<li>...</li>
			</ul>
			<!-- The name of the Web site. Also displays the top left corner. -->
			<div class="siteName">MyDMS</div>
			<!-- Signature tag -->
			<div id="signatory">Signed in as Guest (Sign out)</div>
			<!-- Some unpleasant but necessary CSS house-keeping -->
			<div style="clear: both; height: 0px;">&nbsp;</div>
		</div>

	Page Navigation
		Contains context-sensitive navigation bar (e.g. folder actions, document
		actions, administrative tools), and normally the complete path to the
		folder or document being displayed.

		<div class="headingContainer">
			<ul class="localNav">
				<li id="first">...</li>
				<li>...</li>
			</ul>
			<div class="mainHeading">Root-Folder</div>
			<div style="clear: both; height: 0px;"></div>
		</div>

	Content Heading
		Usually displayed above a content container to act as a heading for the
		following content. There may be more than one Content Heading on a given
		page.

		<div class="contentHeading">Folder Information</div>

  Content Container
		A top level container for any content to be displayed on the page. The
		content container is comprised of a set of 6 nested div elements, styled
		according to taste. In the default theme, "orange", the divs are used to
		display images that create the rounded-corner effect as well as
		displaying borders along each edge and a background gradient along the
		bottom edge of the container.

		It is a complex structure for what might seem to be a trivial effect, but
		it reflects the complexity inherent in the application of cascading style
		sheets to HTML.

		The container elements are structured as follows:

		<!-- Outer element. Required to ensure that IE renders correctly. -->
		<div class="contentContainer">

      <!-- Contains background gradient. Must appear as the bottom layer. -->
      <div class="content">
		    <!-- Displays the left edge of the container. -->
    		<div class="content-l">
    			<!-- Displays the right edge of the container. -->
    			<div class="content-r">
    				<!-- Displays the bottom-right corner of the container. -->
						<div class="content-br">
	    				<!-- Displays the bottom-left corner of the container. -->
							<div class="content-bl">\n";
								Content is displayed here.
							</div>
						</div>
					</div>
				</div>
			</div>
		</div>

For details, please examine the style sheet to see how each element is
managed.