The Zope Book (2.6 Edition)

How the Book Is Organized......Page 32
Conventions Used in This Book......Page 34
Contributors to This Book......Page 35
What Is A Web Application?......Page 36
How You Can Benefit From Using An Application Server......Page 37
Why Use Zope Instead of Another Application Server......Page 38
Zope Audiences and What Zope Isn't......Page 39
Zope's Terms of Use and License and an Introduction to The Zope Community......Page 40
Object Publishing......Page 41
Objects......Page 66
Security and Safe Delegation......Page 42
Zope Is Extensible......Page 43
Acquisition vs. Inheritance......Page 102
Fundamental Zope Components......Page 44
Installing Zope......Page 45
Installing Zope for Windows With Binaries from Zope.org......Page 46
Installing Zope on Linux and Solaris With Binaries from Zope.org......Page 50
Compiling and Installing Zope from Source Code......Page 52
Starting Zope......Page 53
Starting Zope on UNIX......Page 54
Your Zope Installation......Page 55
Logging In......Page 56
Controlling the Zope Process From the Command Line......Page 57
Options To The Zope  start  or  start.bat  Script......Page 58
Environment Variables that Effect Zope at Runtime......Page 61
When All Else Fails......Page 65
Attributes......Page 416
Messages......Page 67
Inheritance......Page 68
Object Lifetimes......Page 69
Summary......Page 316
The Navigator Frame......Page 70
Session Configuration......Page 323
The Workspace Frame......Page 71
Creating Objects......Page 72
Moving and Renaming Objects......Page 73
Transactions and Undoing Mistakes......Page 75
Reviewing Change History......Page 76
Importing and Exporting Objects......Page 77
Using Object Properties......Page 80
Browsing and Searching Help......Page 82
Logging Out......Page 83
Files......Page 84
Creating and Editing Files......Page 85
Viewing Files......Page 86
Presentation Objects: Zope Page Templates and DTML Objects......Page 87
ZPT vs. DTML: Same Purpose, Different Audiences......Page 88
Uploading A Page Template......Page 89
DTML Objects: DTML Documents and DTML Methods......Page 90
Editing DTML Methods......Page 91
Uploading an HTML File as Content for a DTML Method......Page 92
Script (Python) Objects......Page 93
Testing A Script (Python)......Page 94
Uploading A Script (Python)......Page 95
Testing An External Method Object......Page 96
Creating a Basic Zope Application Using Page Templates and Scripts......Page 97
Creatng A Script To Calculate Interest Rates......Page 98
Creating A Page Template To Display Results......Page 99
Dynamically Acquiring Content......Page 115
The Zope Tutorial......Page 100
Say What?......Page 103
Getting Deeper with Multiple Levels......Page 104
When Not To Use DTML......Page 106
The Difference Between DTML Documents and DTML Methods......Page 107
Details......Page 325
DTML Tag Names, Targets, and Attributes......Page 108
Inserting Text into HTML with DTML......Page 109
Formatting and Displaying Sequences......Page 111
Processing Input from Forms......Page 112
Using Python Expressions from DTML......Page 117
will call the method. However,......Page 119
 Var  Tag Attributes......Page 120
Here's an example condition:......Page 121
 Else  and  Elif  Tags......Page 122
Using Cookies with the  If  Tag......Page 123
Iterating over Folder Contents......Page 124
 In  Tag Special Variables......Page 125
How Page Templates Work......Page 128
Creating a Page Template......Page 129
Inserting Text......Page 130
Repeating Structures......Page 131
Conditional Elements......Page 132
Creating a File Library with Page Templates......Page 133
Remote Editing with FTP and WebDAV......Page 136
Debugging and Testing......Page 137
Using Templates with Content......Page 138
Using A Folder as A Container For Your Intstance-Space Application......Page 140
The Special Folder Object  index_html......Page 141
Navigating the Zoo......Page 142
Adding a Front Page to the Zoo......Page 144
Improving Navigation......Page 145
Factoring out Style Sheets......Page 147
Creating a File Library......Page 148
BookmarkTitle:......Page 367
Building a Guest Book......Page 150
Extending the Guest Book to Generate XML......Page 153
The Next Step......Page 154
Zope's "Stock" Security Setup......Page 155
Authorization, Roles, and Permissions......Page 156
Creating Users in User Folders......Page 157
Defining a User's Location......Page 159
Special User Accounts......Page 160
Zope Emergency User......Page 161
Creating an Emergency User......Page 162
Protecting Against Password Snooping......Page 163
Defining Global Roles......Page 164
Understanding Permissions......Page 165
Defining Security Policies......Page 166
Security Policy Acquisition......Page 167
Delegating Control to Local Managers......Page 168
Different Levels of Access with Roles......Page 169
Performing Security Checks......Page 170
Managing Ownership......Page 172
Roles of Executable Content......Page 173
Proxy Roles......Page 174
Advanced DTML......Page 176
How Variables are Looked up......Page 177
DTML Namespaces......Page 178
DTML Client Object......Page 179
DTML Request Object......Page 180
 In  Tag Namespace Modifications......Page 181
The  With  Tag......Page 182
The  Let  Tag......Page 183
DTML Namespace Utility Functions......Page 184
DTML Security......Page 185
The  Call  Tag......Page 186
The  Comment  Tag......Page 187
The  Tree  Tag......Page 188
The  Sendmail  Tag......Page 190
The  Mime  Tag......Page 191
The  Unless  Tag......Page 192
Batch Processing With The  In  Tag......Page 193
The  Try  Tag......Page 195
The  Try  Tag Optional  Finally  Block......Page 197
Sorting with the    tag......Page 198
Explicit Lookups......Page 199
Conclusion......Page 352
Dummy Elements......Page 200
Advanced Repetition......Page 201
The following information is available from the repeat variable:......Page 479
Repetition Tips......Page 202
Defining Variables......Page 203
Error Handling......Page 204
Interactions Between TAL Statements......Page 205
Form Processing......Page 207
Built-in Page Template Variables......Page 208
String Expressions......Page 209
Alternate Paths......Page 210
Exists Expressions......Page 211
Using other Expression Types......Page 212
Getting at Zope Objects......Page 213
Calling DTML......Page 214
TALES String expressions......Page 487
Macros......Page 215
Macro Details......Page 216
Using Slots......Page 217
Customizing Default Presentation......Page 218
Whole Page Macros......Page 219
Caching Templates......Page 220
Batching Large Sets of Information......Page 221
Miscellaneous Utilities......Page 223
Calling Scripts......Page 224
Calling Scripts From the Web......Page 225
Calling Scripts from DTML......Page 226
Calling scripts from Python and Perl......Page 227
Calling Scripts from Page Templates......Page 228
Calling Scripts: Summary and Comparison......Page 229
Creating Python-based Scripts......Page 230
Binding Variables......Page 232
Accessing the HTTP Request......Page 233
Doing Math......Page 234
Print Statement Support......Page 235
Built-in Functions......Page 486
Using External Methods......Page 236
Processing XML with External Methods......Page 241
Using Perl-based Scripts......Page 242
Creating Perl-based Scripts......Page 243
Advanced Acquisition......Page 244
Readability......Page 246
Calling DTML from Scripts......Page 247
Calling ZPT from Scripts......Page 248
Passing Parameters to Scripts......Page 249
Returning Values from Scripts......Page 253
Security Restrictions of Script (Python)......Page 254
Get all objects in a folder......Page 255
Get a property......Page 256
Add a new object to the context......Page 257
Remote Scripting and Network Services......Page 258
Using XML-RPC......Page 259
Remote Scripting with HTTP......Page 260
Access Rule Services......Page 262
Version Services......Page 263
Caching Services......Page 265
Adding a Cache Manager......Page 266
Caching an Object......Page 267
Error Logging Services......Page 268
Special VHM Path Elements  VirtualHostBase  and  VirtualHostRoot......Page 317
Internationalization Services......Page 269
Creating a ZCatalog......Page 270
Creating Indexes......Page 271
Search and Report Forms......Page 273
Defining Indexes......Page 274
Searching ZCatalogs......Page 276
Searching with Forms......Page 277
Searching and Indexing Details......Page 278
Phrase search......Page 279
Searching Field Indexes......Page 280
Searching Keyword Indexes......Page 282
Searching TopicIndexes......Page 283
FieldIndex Record Attributes......Page 284
Creating Records in HTML......Page 287
Path Index Record Attributes......Page 285
DateIndex Record Attributes......Page 286
Automatic Cataloging......Page 288
Common Relational Databases......Page 296
Setting up a Database Connection......Page 297
Examples of ZSQL Methods......Page 300
Displaying Results from Z SQL Methods......Page 303
Providing Arguments to Z SQL Methods......Page 304
Dynamic SQL Queries......Page 305
Equality Comparisons with the  sqltest  Tag......Page 306
Creating Complex Queries with the  sqlgroup  Tag......Page 307
Acquiring Arguments from other Objects......Page 309
Traversing to Result Objects......Page 310
Other Result Object Methods......Page 311
Binding Classes to Result Objects......Page 312
Caching Results......Page 314
Transactions......Page 315
 VirtualHostRoot......Page 318
Testing a Virtual Host Monster......Page 319
Virtual Host Monster  Mappings  Tab......Page 320
Apache Rewrite Rules......Page 321
"Inside-Out" Virtual Hosting......Page 322
Using Session Data......Page 324
Overview......Page 326
Manually Invalidating A Session Data Object......Page 327
Using the  mapping  Keyword With A Session Data Object in a  dtml-with......Page 328
Interacting with Browser Id Data......Page 329
Obtaining the Browser Id Name/Value Pair and Embedding It Into A Form......Page 330
Embedding A Browser Id Into An HTML Link......Page 331
Using Session onAdd and onDelete Events......Page 332
Writing onAdd and onDelete Methods......Page 333
Instantiating Multiple Browser Id Managers (Optional)......Page 334
Instantiating a Transient Object Container......Page 336
Permissions related to session data managers:......Page 337
Browser Id (Non-)Expiration......Page 338
Mutable Data Stored Within Session Data Objects......Page 339
Conflict Errors......Page 340
Further Documentation......Page 341
What is ZEO?......Page 342
When you should use ZEO......Page 343
Installing and Running ZEO......Page 344
How to Run Multiple ZEO Clients......Page 345
User Chooses a Mirror......Page 346
Using Layer 4 Switching to Distribute Load......Page 348
Dealing with the Storage Server as A Single Point of Failure......Page 349
ZEO Server Details......Page 350
ZEO Caveats......Page 351
General Caveats......Page 353
Determining Your Zope's FTP Port......Page 354
Remote Editing with FTP/DAV-Aware Editors......Page 355
Editing Zope Objects with Emacs FTP Modes......Page 356
Note......Page 357
Using a PUT_factory to Specify the Type of Objects Created With FTP and DAV......Page 358
Using The External Editor Product......Page 359
Other Integration Facilities......Page 360
Creating Zope Products......Page 361
Creating A Simple Product......Page 362
Creating ZClasses......Page 365
Creating Views of Your ZClass......Page 368
Creating Properties on Your ZClass......Page 369
Creating Methods on your ZClass......Page 371
ZClass Security Controls......Page 373
Controlling access to Methods and Property Sheets......Page 374
Providing Context-Sensitive Help for your ZClass......Page 375
Using Python Base Classes......Page 376
Distributing Products......Page 377
Distributions with Prepackaged Zope......Page 379
Automatic Startup for Custom-Built Zopes......Page 380
Installing New Products......Page 384
Database Cache......Page 385
ZServer Threads......Page 386
Signals (POSIX only)......Page 387
Monitor the HTTP Service......Page 388
Log Rotation......Page 389
Packing and Backing Up the FileStorage Database......Page 390
Database Recovery Tools......Page 391
comment: Comments DTML......Page 393
Examples......Page 491
HTML Support Features......Page 492
Functions......Page 394
if: Tests Conditions......Page 397
in: Loops over sequences......Page 398
Tag Variables......Page 412
Current Item Variables......Page 399
Batch Variables......Page 400
let: Defines DTML variables......Page 402
mime: Formats data with MIME......Page 403
raise: Raises an exception......Page 404
sendmail: Sends email with SMTP......Page 405
sqlgroup: Formats complex SQL expressions......Page 406
sqltest: Formats SQL condition tests......Page 407
tree: Inserts a tree widget......Page 409
try: Handles exceptions......Page 411
var: Inserts a variable......Page 413
with: Controls DTML variable look up......Page 415
 getUser(self)......Page 417
 has_permission(permission, object)......Page 418
 this()......Page 440
 __call__(client=None, REQUEST={}, RESPONSE=None, **kw)......Page 419
 __call__(client=None, REQUEST={}, **kw)......Page 421
class  DateTime......Page 422
 manage_addZSQLMethod(id, title, connection_id, arguments, template)......Page 465
 manage_addDocument(id, title)......Page 420
 greaterThanEqualTo(t)......Page 425
 ampm()......Page 426
 Time()......Page 427
 rfc822()......Page 428
 Mon()......Page 429
 h_24()......Page 430
 PreciseTime()......Page 431
 Day()......Page 432
 manage_addExternalMethod(id, title, module, function)......Page 433
 update_data(data, content_type=None, size=None)......Page 434
class  Image(File)......Page 435
 send(messageText, mto=None, mfrom=None, subject=None, encode=None)......Page 436
class  ObjectManager......Page 437
 objectValues(type=None)......Page 438
 getPhysicalRoot()......Page 439
class  PropertyManager......Page 441
 propertyValues()......Page 442
 propertyIds()......Page 444
 manage_changeProperties(REQUEST=None, **kw)......Page 443
class  PythonScript(Script)......Page 445
 setCookie(name, value, **kw)......Page 451
 setVirtualRoot(path, hard=0)......Page 450
 ZPythonScript_edit(params, body)......Page 447
module  Request......Page 448
class  Request......Page 449
 expireCookie(name, **kw)......Page 452
class  SessionDataManagerErr......Page 453
 flushBrowserIdCookie(self)......Page 454
class  SessionDataManagerInterface......Page 455
class  TransientObject......Page 456
 update(self, d)......Page 457
 setAddNotificationTarget(self, f)......Page 459
module  UserFolder......Page 460
class  MaxTransientObjectsExceeded......Page 458
class  Vocabulary......Page 461
 schema()......Page 462
 searchResults(REQUEST=None, **kw)......Page 463
class  ZSQLMethod......Page 464
 __init__(self, sequence, size, start=0, end=0, orphan=0, overlap=0)......Page 466
 def sort(seq, sort)......Page 467
Products.PythonScripts.standard: Utility functions and classes......Page 468
 def url_quote(s)......Page 469
string: Python  string  module......Page 470
TAL Statements......Page 472
Order of Operations......Page 473
condition: Conditionally insert or remove an element......Page 474
content: Replace the content of an element......Page 475
omit-tag: Remove an element, leaving its contents......Page 476
on-error: Handle errors......Page 477
repeat: Repeat an element......Page 478
replace: Replace an element......Page 480
TALES Expression Types......Page 481
Built-in Names......Page 482
TALES Nocall expressions......Page 483
TALES Path expressions......Page 484
METAL Statements......Page 488
define-macro: Define a macro......Page 489
fill-slot: Customize a macro......Page 490
Python Information......Page 494
DTML Name Lookup Rules......Page 495