Documentation/English (British)/developer-chapter1-kiriwritesettingsedit.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">\r
   2 <html>\r
   3         <head>\r
   4                 <link href="style.css" REL="stylesheet" TYPE="text/css" MEDIA="screen">\r
   5                 <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">\r
   6                 <title>Kiriwrite Documentation - Developer Documentation - 1.28: kiriwrite_settings_edit</title>\r
   7         </head>\r
   8         <body>\r
   9                 <div class="menubarback">\r
  10                         <div class="menubar">\r
  11                                 <span class="apptitle">Kiriwrite</span>\r
  12                                 <a href="index.html">Index</a> | <a href="user.html">User \r
  13 Documentation</a> | <a href="tutorial.html">Tutorial Documentation</a> | \r
  14 <a href="developer.html">Developer Documentation</a>\r
  15                         </div>\r
  16                 </div>\r
  17                 <div class="pageinformation">\r
  18                         <span class="pagetitle">1.28 kiriwrite_settings_edit</span><br><br>\r
  19 \r
  20 kiriwrite_settings_edit will edit the settings in Kiriwrite and write the new settings to the configuration file.<br><br>\r
  21 \r
  22 kiriwrite_settings_edit will return data that is intended for kiriwrite_output_page.<br><br>\r
  23 \r
  24 <span class="heading">Parameters:</span><br><br>\r
  25 \r
  26 <div class="code">\r
  27     kiriwrite_settings_edit(options);\r
  28 </div>\r
  29 \r
  30 <br>\r
  31 \r
  32 <span class="heading">Usage:</span><br><br>\r
  33 \r
  34 <div class="code">\r
  35     $pagedata = kiriwrite_settings_edit({ DatabaseDirectory => &quot;db&quot;, OutputDirectory => &quot;output&quot;, ImagesURIPath => &quot;/images/kiriwrite&quot;, DateTimeFormat => &quot;DD/MM/YY (hh:mm:ss)&quot;, SystemLanguage => &quot;en-GB&quot;, PresentationModule => &quot;HTML4S&quot;, TextAreaCols => 50, TextAreaRows => 10, DatabaseModule => &quot;SQLite&quot;, DatabaseServer => &quot;localhost&quot;, DatabasePort => &quot;3306&quot;, DatabaseProtocol => &quot;tcp&quot;, DatabaseSQLDatabase => &quot;database&quot;, DatabaseUsername => &quot;username&quot;, DatabasePasswordKeep => 0, DatabasePassword => &quot;password&quot;, DatabaseTablePrefix = &quot;kiridev&quot; });\r
  36 </div>\r
  37 \r
  38 <br>\r
  39 \r
  40 <i>options</i><br>\r
  41 Specifies a hash listing the new settings. This is required when editing the settings and all settings are needed.<br><br>\r
  42 \r
  43 <table class="infotable">\r
  44     <tr>\r
  45         <td class="tableheading">Value</td>\r
  46         <td class="tableheading">Description</td>\r
  47     </tr>\r
  48     <tr>\r
  49         <td class="tabledata">DatabaseDirectory</td>\r
  50         <td class="tabledata">Specifies the database directory to use.</td>\r
  51     </tr>\r
  52     <tr>\r
  53         <td class="tabledata">OutputDirectory</td>\r
  54         <td class="tabledata">Specifies the output directory to use.</td>\r
  55     </tr>\r
  56     <tr>\r
  57         <td class="tabledata">ImagesURIPath</td>\r
  58         <td class="tabledata">Specifies the URI path of the images directory.</td>\r
  59     </tr>\r
  60     <tr>\r
  61         <td class="tabledata">DateTimeFormat</td>\r
  62         <td class="tabledata">Specifies the date and time format that should be used.</td>\r
  63     </tr>\r
  64     <tr>\r
  65         <td class="tabledata">SystemLanguage</td>\r
  66         <td class="tabledata">Specifies the language that Kiriwrite will use.</td>\r
  67     </tr>\r
  68     <tr>\r
  69         <td class="tabledata">PresentationModule</td>\r
  70         <td class="tabledata">Specifies the presentation module in Kiriwrite to use.</td>\r
  71     </tr>\r
  72     <tr>\r
  73         <td class="tabledata">TextAreaCols</td>\r
  74         <td class="tabledata">Specifies the width of the text area.</td>\r
  75     </tr>\r
  76     <tr>\r
  77         <td class="tabledata">TextAreaRows</td>\r
  78         <td class="tabledata">Specifies the height of the text area.</td>\r
  79     </tr>\r
  80     <tr>\r
  81         <td class="tabledata">DatabaseModule</td>\r
  82         <td class="tabledata">Specifies the database module in Kiriwrite to use.</td>\r
  83     </tr>\r
  84 </table>\r
  85 \r
  86 <br>\r
  87 \r
  88 The following settings are for the server-based database modules:<br><br>\r
  89 \r
  90 <table class="infotable">\r
  91     <tr>\r
  92         <td class="tableheading">Value</td>\r
  93         <td class="tableheading">Description</td>\r
  94     </tr>\r
  95     <tr>\r
  96         <td class="tabledata">DatabaseServer</td>\r
  97         <td class="tabledata">Specifies the location of the database server.</td>\r
  98     </tr>\r
  99     <tr>\r
 100         <td class="tabledata">DatabasePort</td>\r
 101         <td class="tabledata">Specifies the port of the database server.</td>\r
 102     </tr>\r
 103     <tr>\r
 104         <td class="tabledata">DatabaseProtocol</td>\r
 105         <td class="tabledata">Specifies the protocol to use with the database server.</td>\r
 106     </tr>\r
 107     <tr>\r
 108         <td class="tabledata">DatabaseSQLDatabase</td>\r
 109         <td class="tabledata">Specifies the database name to use.</td>\r
 110     </tr>\r
 111     <tr>\r
 112         <td class="tabledata">DatabaseUsername</td>\r
 113         <td class="tabledata">Specifies the database username to use.</td>\r
 114     </tr>\r
 115     <tr>\r
 116         <td class="tabledata">DatabasePasswordKeep</td>\r
 117         <td class="tabledata">Specifies if the current database password should be kept.</td>\r
 118     </tr>\r
 119     <tr>\r
 120         <td class="tabledata">DatabasePassword</td>\r
 121         <td class="tabledata">Specifies the database password to use.</td>\r
 122     </tr>\r
 123     <tr>\r
 124         <td class="tabledata">DatabaseTablePrefix</td>\r
 125         <td class="tabledata">Specifies the table prefix to use for the tables used in Kiriwrite when using a server-based database module.</td>\r
 126     </tr>\r
 127 </table>\r
 128                 </div>\r
 129         </body>\r
 130 </html>\r