### Handle Installation Redirect

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/index.txt

Handles the redirection to the installation page when an installation is initiated. It uses the 'form.install' variable to determine the package to install.

```XML
<if variable="form.install">
  <redirect to="update.html?page=install&amp;install=&form.install;&amp;&usr.set-wiz-id;" />
</if>
```

--------------------------------

### Installation Confirmation Buttons

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/install.txt

Presents the user with confirmation buttons ('Yes' and 'No') to proceed with or cancel the package installation.

```roxen
<input type="hidden" name="install" value="&form.install;" />
<translate id="29" variable="var.title">Yes</translate>
<input type="submit" name="yes" value="   &var.title;   " />&nbsp;&nbsp;&nbsp;
<translate id="30" variable="var.title">No</translate>
<input type="submit" name="no" value="   &var.title;   " />
```

--------------------------------

### Package Update and Return Link

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/install.txt

Updates the installed package and provides a link to return to the update page if the 'yes' form variable is set.

```roxen
<if variable="form.yes">
  <update-install-package package="&form.install;" /><br />
  <a href="update.html"><translate id="23">[Return]</translate></a>
</if>
```

--------------------------------

### Install Roxen MIB Data Queries for Cacti

Source: https://github.com/pikelang/roxen/blob/devel/server/tools/cacti/README.txt

This snippet details the installation of Roxen MIB data query files into the Cacti installation directory. The XML files 'roxen-mib_core.xml' and 'roxen-mib_feed.xml' need to be copied to the 'resource/snmp_queries' folder.

```bash
Copy "roxen-mib_core.xml" and "roxen-mib_feed.xml" to the
  "resource/snmp_queries" directory in the cacti installation, this is
  typically the following directory:

    /usr/share/cacti/resource/snmp_queries
```

--------------------------------

### Handle Package Installation/Uninstallation (Pikelang)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/details.txt

Manages the package installation and uninstallation process using Pikelang's conditional logic based on download and installation status. It generates hidden input fields and submit buttons for user actions.

```Pikelang
<update-package-is-downloaded package="&form.details;"
   variable="downloaded" installed_variable="installed" />
<if variable="form.installed">
  <input type="hidden" name="uninstall_package" value="&form.details;" />
  <input type="submit" name="do_uninstall" value="Uninstall this package" />
</if>
<else>
<if not variable="form.downloaded">
  <input type="hidden" name="details" value="&form.details;" />
  <input type="submit" name="download" value="Download this package" />
</if>
<else>
  <input type="hidden" name="install" value="&form.details;" />
  <input type="submit" name="do_install" value="Install this package" />
</else>
</else>
```

--------------------------------

### Handle Download Start and Redirect

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/index.txt

Initiates the download of a package and then redirects the user to a status page. It uses 'form.download' to trigger the download and 'form.details' to specify the package.

```XML
<if variable="form.download">
  <update-start-download package="&form.details;" />
  <redirect to="update.html?bar&amp;&usr.set-wiz-id;" />
</if>
```

--------------------------------

### Display Package Details Table

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/install.txt

Displays detailed information about a package, including description, organization, author, license, and date, using the 'item' definition.

```roxen
<update-package package="&form.install;" scope="pkg">
<table>
  <translate id="14" variable="var.title">Description</translate>
  <item title="&var.title;" name="description" type="pre" />
  <translate id="19" variable="var.title">Organization</translate>
  <item title="&var.title;" name="organization" />
  <translate id="20" variable="var.title">Author</translate>
  <item title="&var.title;" name="author-name" />
  <translate id="21" variable="var.title">License</translate>
  <item title="&var.title;" name="license" />
  <translate id="22" variable="var.title">Date</translate>
  <item title="&var.title;" name="date" />
</table>
</update-package>
```

--------------------------------

### Define Package Item Structure

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/install.txt

Defines a reusable structure for displaying package item details, conditionally formatting preformatted text.

```roxen
<define tag="item">
  <tr valign="top">
    <td align="right"><b>&_.title;:</b></td>
    <if variable="_.type == pre">
      <td><pre><insert variable="pkg.&_.name;" /></pre></td>
    </if>
    <else>
      <td><insert variable="pkg.&_.name;" /></td>
    </else>
  </tr>
</define>
```

--------------------------------

### Toggle Package Contents Visibility

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/install.txt

Provides a submit button to toggle the visibility of package contents. If 'show' is true, it displays a 'Hide' button; otherwise, it shows an 'Show' button.

```roxen
<if variable="form.show">
  <translate id="24" variable="var.title">Hide package contents</translate>
  <input type=submit name="hide" value="&var.title;"><br />
  <br />
  <translate id="25" variable="var.title">The following files will be installed:</translate>
  <cv-obox title="&var.title;">
  <table cellpadding="0">
    <tr>
      <td nowrap="nowrap"><b><translate id="15">Size</translate></b></td>
      <td>&nbsp;</td>
      <td nowrap="nowrap"><b><translate id="26">Path</translate></b></td>
    </tr>
    <update-package-contents package="&form.install;">
      <tr>
        <td align="right" nowrap="nowrap">&_.size;</td>
        <td>&nbsp;</td>
        <td nowrap="nowrap">&_.path;</tt></td>
      </tr>
    </update-package-contents>
  </table>
  </cv-obox>
</if>
<else>
  <translate id="27" variable="var.title">Show package contents</translate>
  <input type="submit" name="show" value="&var.title;" />
</else>
```

--------------------------------

### Conditional Redirection

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/install.txt

Redirects the user to 'update.html' if the 'no' form variable is set, indicating a cancellation or negative response.

```roxen
<if variable="form.no">
  <redirect to="update.html?foo&amp;&usr.set-wiz-id;" />
</if>
```

--------------------------------

### Define Downloaded Packages Display

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/index.txt

Defines the structure for displaying a list of already downloaded packages. It includes the package title, size, and an option to install the package.

```XML
<define variable="var.dp" preparse="">
  <update-downloaded-packages>
  <tr>
    <td nowrap="nowrap">&_.title;
      <a href="update.html?page=details&amp;details=&_.id;&amp;&usr.set-wiz-id;">[Details...]</a></td>
    <td nowrap="nowrap">&_.size;</td>
    <td nowrap="nowrap">
      <a href="update.html?install=&_.id;&amp;&usr.set-wiz-id;">[Install...]</a>
    </td>
  </tr>
  </update-downloaded-packages>
</define>
```

--------------------------------

### Roxen Configuration Interface Boxes

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Information on creating custom 'content boxes' for the Roxen configuration interface. Users can find examples and instructions in the _config_interface/boxes_ directory.

```Roxen
&_.name;
&_.contents:none;
```

--------------------------------

### Locate File in Virtual Filesystem (RXML)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Illustrates the use of the 'locate' argument within the '<insert>' or '<use>' tags. This feature searches for a specified file starting from the current directory and moving upwards in the virtual filesystem hierarchy.

```RXML
<insert locate="filename">
```

```RXML
<use locate="filename">
```

--------------------------------

### Pike Thread Creation Example

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew-pike.html

Demonstrates how to create a new thread in Pike. The function provided as an argument to thread_create is executed in a separate thread, allowing for concurrent operations. This example shows a simple thread that continuously writes a message and sleeps.

```Pike
thread_create() {
  while( 1 ) { write("I am a thread\n"); sleep( 1 ); }
};
```

--------------------------------

### Send Game State

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/mastermind.html

This function constructs a string representing the current game state, including turn number and color selections, and then redirects the user to a masterminds HTML page with these parameters. It also handles optional parameters.

```javascript
function send() {
  var ret="";
  turn++;
  for(var i = 1; i < 7; i++) ret+=arrej[i];
  top.location="mastermind.html?turn="+turn+"&amp;or"+turn+"="+ret+old+"&amp;q="+quest+"&amp;&usr.set-wiz-id;";
}
```

--------------------------------

### Update Package List and Scan Local Packages

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/index.txt

Triggers an update of the package list from the main server and then scans for locally installed packages. This ensures the system has the latest package information.

```XML
<if variable="form.update_list">
  <update-update-list/>
  <update-scan-local-packages/>
  <translate id="7">Launched a package list update request.</translate><br />
</if>
```

--------------------------------

### Shift Image Color

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/mastermind.html

This function shifts the color of an image based on its index. It handles a bug in Internet Explorer and cycles through a predefined array of colors. The image source is updated dynamically.

```javascript
function tomArrej() { for(var i = 0; i < 7; i++) this[i] = 0; }
arrej = new tomArrej();
colors = new tomArrej();
colors[0] = "white";
colors[1] = "blue";
colors[2] = "green";
colors[3] = "yellow";
colors[4] = "purple";
colors[5] = "red";
function shiftColor(imgName) {
  if(buggy_image_counter) imgName--;
  arrej[imgName] = (arrej[imgName]+1)%6;
  document [imgName].src = "/internal-roxen-pixel-" + colors[arrej[imgName]];
}
```

--------------------------------

### Populate Package Information Fields (Pikelang)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/details.txt

Populates various package information fields such as description, size, author, and license using the 'item' definition and Pikelang's translate and update-package directives.

```Pikelang
<update-package package="&form.details;" scope="pkg">
<table>
  <translate id="14" variable="var.title">Description</translate>
  <item title="&var.title;" name="description" type="pre" />
  <translate id="15" variable="var.title">Size</translate>
  <item title="&var.title;" name="size" />
  <translate id="19" variable="var.title">Organization</translate>
  <item title="&var.title;" name="organization" />
  <translate id="20" variable="var.title">Author</translate>
  <item title="&var.title;" name="author-name" />
  <translate id="21" variable="var.title">License</translate>
  <item title="&var.title;" name="license" />
  <translate id="22" variable="var.title">Date</translate>
  <item title="&var.title;" name="date" />
</table>
</update-package>
```

--------------------------------

### Pike Class Definition Comparison

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew-pike.html

Compares two equivalent ways to define a class in Pike. The first shows a traditional definition with explicit member declarations and a create method. The second demonstrates a more concise syntax using constructor arguments with access specifiers.

```Pike
class Foo 
{
  int a;
  protected string b;

  protected void create(int _a, string _b)
  {
    a = _a;
    b = _b;
  }
}
```

```Pike
class Foo(int a, protected string b)
{
}
```

--------------------------------

### Configure Roxen Device in Cacti

Source: https://github.com/pikelang/roxen/blob/devel/server/tools/cacti/README.txt

This snippet outlines the configuration steps for adding a Roxen device to Cacti for monitoring. It specifies the necessary parameters such as Description, Hostname, Host Template, SNMP Community, and SNMP Port.

```bash
Description:    "PRINT example.roxen.com"
Hostname:       "example.roxen.com"
Host Template:  "Roxen MIB - Editorial Portal"
SNMP Community: "public"
SNMP Port:      "16180"
```

--------------------------------

### Roxen Image Cropping and Padding

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Details on image manipulation parameters in Roxen, specifically 'span-width' and 'span-height' for padding smaller images, and 'crop=guides-cross' with 'guides-index' for cropping around specific points or regions. These are useful for thumbnail generation.

```Roxen
span-width=200
span-height=150
```

```Roxen
crop=guides-cross guides-index=100,100
```

```Roxen
crop=guides-region guides-index=50,50-150,150
```

--------------------------------

### Define Download Progress Display

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/index.txt

Defines the structure for displaying the progress of ongoing package downloads. It shows the package title, a link to details, size, and download progress percentage.

```XML
<define variable="var.dip" preparse="">
  <update-download-progress>
  <tr>
    <td nowrap="nowrap">&_.title;
      <a href="update.html?details=&_.id;&amp;&usr.set-wiz-id;">[Details...]</a></td>
    <td nowrap="nowrap">&_.size;</td>
    <td nowrap="nowrap">&_.progress;%</td>
  </tr>
  </update-download-progress>
</define>
```

--------------------------------

### Calculate Page Download Time (Roxen Module)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Provides a tag, '<page-size>', that estimates the download time for a web page, considering factors like inline images and HTTP headers, across different connection speeds.

```Roxen
<page-size>
```

--------------------------------

### Display Download Progress and Downloaded Packages

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/index.txt

Combines and displays information about packages currently downloading and those already downloaded. It conditionally shows these sections if there are more than 4 items in each list, and a horizontal rule if the combined list exceeds 8 items.

```XML
<set variable="var.both" from="var.dip" />
<append variable="var.both" from="var.dp" />

<if sizeof="var.both > 8">
<hr size="1" width="95%" />
<table>
<tr valign="top">

<if sizeof="var.dip > 4">
<td>
  <translate id="13" variable="var.title">Downloads&nbsp;in&nbsp;progress</translate>
  <cv-obox title="&var.title;">
    <table cellpadding="4">
      <tr>
        <td nowrap="nowrap"><b><translate id="14">Description</translate></b></td>
        <td nowrap="nowrap"><b><translate id="15">Size</translate></b></td>
        <td nowrap="nowrap"><b><translate id="16">Downloaded</translate></b></td>
     </tr>
     &var.dip:none;
    </table>
  </cv-obox>
</td>
</if>
<if sizeof="var.dp > 4">
<td>
  <translate id="17" variable="var.title">Downloaded&nbsp;packages</translate>
  <cv-obox title="&var.title;">
    <table cellpadding="4">
      <tr>
        <td nowrap="nowrap"><b><translate id="14">Description</translate></b></td>
        <td nowrap="nowrap"><b><translate id="15">Size</translate></b></td>
        <td nowrap="nowrap"></td>
      </tr>
      &var.dp:none;
    </table>
  </cv-obox>
</td>
</if>
</tr></table>  
</if>
```

--------------------------------

### Automatically Use Package (Roxen Module)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

This module automatically includes a specified package before any RXML parsing occurs. It's useful for template files where common tags and variables need to be available globally.

```Roxen
Automatically <use> a package before parsing files.
```

--------------------------------

### Define Package Item Structure (Pikelang)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/details.txt

Defines the structure for displaying package item details, including conditional formatting for 'pre' type items. It uses Pikelang's templating and variable insertion.

```Pikelang
<define tag="item">
  <tr valign="top">
    <td align="right"><b>&_.title;:</b></td>
    <if match="&_.type; is pre">
      <td><pre><insert variable="pkg.&_.name;" /></pre></td>
    </if>
    <else>
      <td><insert variable="pkg.&_.name;" /></td>
    </else>
  </tr>
</define>
```

--------------------------------

### Toggle Table and Image Borders (Roxen Module)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

A utility module for HTML authors that allows toggling the visibility of table borders and image borders using a prestate, aiding in layout design and debugging.

```Roxen
toggle the viewing of table and image borders using a prestate
```

--------------------------------

### ROXEN-MIB Definitions

Source: https://github.com/pikelang/roxen/blob/devel/server/etc/ROXEN-MIB.txt

This snippet contains the complete definitions for the ROXEN-MIB, including imports from SNMPv2-SMI and definitions for object identifiers, object types, and sequences related to the Roxen web server's management information.

```ASN.1
ROXEN-MIB DEFINITIONS ::=
BEGIN

IMPORTS
    enterprises, Integer32, IpAddress, Counter32,
    Gauge32, Unsigned32, TimeTicks, Opaque, Counter64
        FROM SNMPv2-SMI
    ;

roxenis		OBJECT IDENTIFIER ::= { enterprises 8614 }
app		OBJECT IDENTIFIER ::= { roxenis 1 }
webserver	OBJECT IDENTIFIER ::= { app 1 }
sites		OBJECT-TYPE
    SYNTAX	SEQUENCE OF Site
    ACCESS	not-accessible
    STATUS	current
    DESCRIPTION	"The table of sites in the server."
    INDEX	{ siteNumber }
    ::= { webserver 2 }

Site ::= SEQUENCE {
    siteNumber		INTEGER,
    siteName		OCTET STRING,
    comment		OCTET STRING,
    sentBytes		Counter64,
    receivedBytes	Counter64,
    sentHeaders		Counter64,
    numRequests		Counter64,
    moduleTable		SEQUENCE OF moduledata ModuleData
}

siteNumber	OBJECT-TYPE
    SYNTAX	INTEGER
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The number identifying the site in the server."
    ::= { sites 1 }
siteName	OBJECT-TYPE
    SYNTAX	OCTET STRING
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The display name of the site."
    ::= { sites 2 }
comment	OBJECT-TYPE
    SYNTAX	OCTET STRING
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The comment for the site."
    ::= { sites 3 }
sentBytes OBJECT-TYPE
    SYNTAX	Counter64
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The number of bytes sent."
    ::= { sites 4 }
receivedBytes OBJECT-TYPE
    SYNTAX	Counter64
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The number of bytes received."
    ::= { sites 5 }
sentHeaders OBJECT-TYPE
    SYNTAX	Counter64
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The number of bytes of received headers."
    ::= { sites 6 }
numRequests OBJECT-TYPE
    SYNTAX	Counter64
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The number of requests handled."
    ::= { sites 7 }
modules		OBJECT-TYPE
    SYNTAX	SEQUENCE OF Module
    ACCESS	not-accessible
    STATUS	current
    DESCRIPTION	"The table of modules in the server."
    INDEX	{ siteNumber moduleIdentifier moduleCopy }
    ::= { sites 8 }
Module ::= SEQUENCE {
    stdModuleInfo	SEQUENCE OF StdModuleInfo,
    customModuleInfo	OBJECT
}
stdModuleInfo		OBJECT IDENTIFIER ::= { modules 1 }
customModuleInfo	OBJECT-TYPE
    SYNTAX	SEQUENCE OF OBJECT
    ACCESS	not-accessible
    STATUS	current
    DESCRIPTION	"Custom module-specific data."
    INDEX	{ moduleIdentifier siteNumber moduleCopy }
    ::= { modules 2 }
StdModuleInfo ::= SEQUENCE {
    moduleCopy		INTEGER,
    moduleIdentifier	OCTET STRING,
    moduleType		INTEGER,
    moduleVersion	OCTET STRING
}
moduleCopy	OBJECT-TYPE
    SYNTAX	INTEGER
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The module copy number in this site."
    ::= { stdModuleInfo 1 }
moduleIdentifier	OBJECT-TYPE
    SYNTAX	OCTET STRING
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The module identifier."
    ::= { stdModuleInfo 2 }
moduleType	OBJECT-TYPE
    SYNTAX	INTEGER
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The module type."
    ::= { stdModuleInfo 3 }
moduleVersion	OBJECT-TYPE
    SYNTAX	OCTET STRING
    ACCESS	read-only
    STATUS	current
    DESCRIPTION	"The module version."
    ::= { stdModuleInfo 4 }

END
```

--------------------------------

### Pike: Regular Expression Matching

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew-pike.html

Illustrates the use of regular expressions for pattern matching in Pike. It shows how to find all occurrences of a pattern within a list of strings.

```Pike
Regexp("[0-9]+")->match( ({ "hello", "12", "foo17" }) );
```

--------------------------------

### Create RXML Tag Set (Old Method)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

This snippet demonstrates the previous method for creating RXML tag sets in Roxen modules using Pike. It highlights the use of a potentially non-unique string identifier.

```Pike
RXML.TagSet internal = RXML.TagSet("TagFoldlist.internal", ({ TagFT(), TagFD() }) );
```

--------------------------------

### Pike: Type Checking and Conditional Logic

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew-pike.html

Demonstrates how to check the type of a variable and use conditional logic based on its value. It also shows how to cast values and print output.

```Pike
constant boolean = typeof(0)|typeof(1);
boolean flag = 1;

int main( int argc, array(string) argv )
{
   flag = (argc>1)?(int)argv[1]:flag;
   write( "Type of flag is %O\n", typeof(flag) );
   write( "Value of flag is %O\n", flag );
   return 0;
}
```

```Pike
typedef int(0..1) boolean;
boolean flag = 1;

int main( int argc, array(string) argv )
{
  flag = (argc>1)?(int)argv[1]:flag;
  write( "Type of flag is %O\n", typeof(flag) );
  write( "Value of flag is %O\n", flag );
  return 0;
}
```

```Pike
enum boolean {
  false,true
}
boolean flag = true;
```

--------------------------------

### Display Package Categories

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/index.txt

Displays different categories of packages available for update, including general products, security fixes, bug fixes, and third-party modules. It uses the 'cat-list' component for each category.

```XML
<translate id="9" variable="var.title">Products</translate>
<cat-list name="idonex" title="&var.title;" />
<translate id="10" variable="var.title">Security fixes</translate>
<cat-list name="security" title="&var.title;" />
<translate id="11" variable="var.title">Bug fixes</translate>
<cat-list name="bugfixes" title="&var.title;" />
<translate id="12" variable="var.title">Third party modules</translate>
<cat-list name="3rdpart" title="&var.title;" />
```

--------------------------------

### Create RXML Tag Set (New Method)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

This snippet illustrates the updated method for creating RXML tag sets in Roxen modules with Pike. It shows the use of the module itself and a module-specific identifier, addressing previous uniqueness and encoding concerns.

```Pike
RXML.TagSet internal = RXML.TagSet(this_module(), "foldlist", ({ TagFT(), TagFD() }) );
```

--------------------------------

### Import Roxen MIB Host Template for Cacti

Source: https://github.com/pikelang/roxen/blob/devel/server/tools/cacti/README.txt

This snippet describes the process of importing the Roxen MIB host template into Cacti. It involves using Cacti's 'Import Templates' function with the provided XML file.

```bash
Import the "cacti_host_template_roxen_mib_editorial_portal.xml" file into cacti via the "Import Templates" function.
```

--------------------------------

### New Entities in RXML (RXML)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Introduces new entities like '&unique-id;' and '&client.session;' to facilitate the creation of session-driven applications with minimal effort.

```RXML
&unique-id;
```

```RXML
&client.session;
```

--------------------------------

### Generate Robots.txt On Demand (Roxen Module)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

A Roxen module that dynamically generates a robots.txt file based on various available information, likely including server configuration and site content.

```Roxen
Generates a robots.txt on demand
```

--------------------------------

### Pike SQL Query with Parameterization

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew-pike.html

Demonstrates how to perform SQL queries in Pike using sprintf-style formatting for automatic, database-specific quoting of parameters. This prevents SQL injection vulnerabilities and simplifies query construction.

```Pike
db->query("SELECT * FROM things WHERE id > %d AND name LIKE %s",
             lowest, pattern);
```

--------------------------------

### Handle Package Uninstallation

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/index.txt

Handles the uninstallation of a specified package. It uses the 'form.uninstall_package' variable to identify the package to be removed.

```XML
<if variable="form.uninstall_package">
  <update-uninstall-package package="&form.uninstall_package;">
</if>
```

--------------------------------

### Set Variable with Container Tag (RXML)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Demonstrates how to set a variable using RXML's container tag syntax. The value assigned to the variable is the content enclosed within the opening and closing tags.

```RXML
<set variable="foo">bar</set>
```

--------------------------------

### Define Package Category List

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/index.txt

Defines a reusable component to display a list of packages within a specific category. It includes functionality to update packages, display details, and manage package lists.

```XML
<define tag="cat-list" scope="cat">
  <br />
  <table bgcolor="&usr.obox-titlebg;" width="100%">
    <tr><td><font size="+1" color="&usr.obox-titlefg;"><b>&_.title;</b></font></td></tr>
  </table>
  <rul>
  <update-package type="&_.name;" limit="5">
    <eval><rli>&_.title; <a href="update.html?page=details&amp;details=&_.id;&amp;&usr.set-wiz-id;">
      <translate id="3">[Details...]</translate></a></rli></eval>
    <set variable="var._&cat.name;" value='foo'/>
  </update-package>
  </rul>
  <if not="1" variable="var._&_.name;">
     &nbsp; <translate id="4">Currently no packages in this category.</translate><br />
  </if>
  <else>
    <a href="update.html?page=category&amp;category=&_.name;&amp;&usr.set-wiz-id;">
      <translate id="5">[More..]</translate></a><br />
  </else>
  &nbsp;
</define>
```

--------------------------------

### RXML Caching with Nested Tags (RXML)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Demonstrates how the RXML '<cache>' tag handles nested '<cache>' and '<nocache>' tags. It allows for caching parts of RXML code while keeping other sections dynamic.

```RXML
<cache>
  ... RXML code ...
  <nocache>
    ... dynamic content ...
  </nocache>
  ... more RXML code ...
</cache>
```

--------------------------------

### Roxen RXML User Authentication

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Demonstrates how to use user and group authentication from the htaccess module within RXML pages using the '<if user=username>' directive. This allows for conditional content display based on authenticated users.

```RXML
<if user=username>
  <!-- Content visible only to authenticated users -->
</if>
```

--------------------------------

### RXML Cache with Variable Assignment (RXML)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Illustrates using the '<cache>' tag in RXML to assign the result of a costly operation (like an SQL query) to a variable, which can then be used outside the cache block for dynamic formatting.

```RXML
<cache>
  <!-- Perform costly operation and assign to variable -->
  <set variable="cached_data">sql_query_result</set>
</cache>

<!-- Use the cached variable -->
<p>Data: &cached_data;</p>
```

--------------------------------

### Highlight Words in HTML Pages (Roxen Module)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

A module designed to highlight specific words within HTML pages. It typically uses a form variable named 'highlight' to determine which words to emphasize, often for search engine result presentation.

```Roxen
Highlights the words stored in the form variable highlight
```

--------------------------------

### Update Package Details Table (Pikelang)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/details.txt

Updates the package details table with a title row, using Pikelang's update-package directive and user-defined color variables.

```Pikelang
<update-package package="&form.details;">
  <table bgcolor="&usr.obox-titlebg;" width="100%">
    <tr><td><font size="+1" color="&usr.obox-titlefg;"><b>&_.title;</b></font></td></tr>
  </table>
</update-package>
```

--------------------------------

### Operating System Calls Module in Pike

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew-pike.html

A new module provides access to various operating system calls previously available as efuns. These include functions like hardlink, symlink, resolvepath, umask, chmod, chown, and chroot. These efuns will be moved to compat mode in the future but remain accessible via the system module.

```Pike
system->hardlink("old_path", "new_path");
system->chmod("file.txt", 0777);
```

--------------------------------

### Roxen Caching with RXML Context Set Misc

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Illustrates using RXML_CONTEXT->set_misc within a cache tag to manage state changes that the cache system can track. This method keeps variables internal and not user-accessible.

```RXML
<cache>
  <my-set value="foo"/>  
</cache>
...
<my-get/>
```

```Pike
RXML_CONTEXT->set_misc("my_value", "foo")
```

--------------------------------

### Pike Version Compatibility Directive

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew-pike.html

Illustrates the use of the #pike preprocessor directive to specify the Pike version a script is intended for. This allows the interpreter to apply appropriate compatibility features, ensuring older scripts run correctly on newer versions and vice-versa.

```Pike
#pike 7.0
```

--------------------------------

### Roxen Caching with RXML Set Variable

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Demonstrates how to use RXML.set_var within a cache tag to ensure variable assignments are reapplied when cached content is reused. This method makes variables user-accessible.

```RXML
<cache>
  <my-set value="foo"/>  
</cache>
...
<my-get/>
```

```Pike
RXML.set_var("my_value", "foo", "var")
```

--------------------------------

### Access Form Variables by Index (RXML)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Shows how to access multiple form variables with the same name by using an index. This allows for iterating through or selecting specific instances of repeated form fields.

```RXML
&form.file.1;
```

```RXML
&form.file.2;
```

--------------------------------

### Display Last Updated Information

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/update/index.txt

Displays the time elapsed since the last synchronization with the main server. This provides users with information about the freshness of the package data.

```XML
<eval><translate id="8">This information was last synchronized with the main server
 &var.last_updated; ago.</translate></eval>
```

--------------------------------

### Pike: Class Inheritance and Method Overriding

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew-pike.html

Demonstrates class inheritance and method overriding in Pike. It shows how a derived class can inherit and modify behavior from a base class.

```Pike
class A {
  int foo() { return 1; }
  int bar() { return foo(); }
  int baz() { return local::foo(); }
}

class B : A {
  int foo() { return 2; }
}

B()->bar();
B()->baz();
```

--------------------------------

### RXML Expression Evaluation (RXML)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

The 'expr' argument in RXML now supports more complex expressions, including type conversions and the use of complex data types, enhancing the flexibility of expression evaluation.

```RXML
expr argument (expression evaluation)
```

--------------------------------

### URL Backslash Stripping (Roxen)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

The '--strip-backslash' option transforms all backslashes ('\') in a URL to forward slashes ('/'). This is primarily for NT compatibility on Unix systems.

```Roxen
--strip-backslash
```

--------------------------------

### Pike Labeled Loops with Break and Continue

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew-pike.html

Shows how to use labeled loops in Pike, allowing 'break' and 'continue' statements to reference specific loops by name. This enhances control flow within nested loops, enabling more precise exit or iteration skipping.

```Pike
int a, b;
foo: 
  for (int i = 1; i <= 4; i++) {
    a = i;
    switch (1) {
      case 1:
        if (i >= 3) break foo;
        if (i >= 2) continue foo;
    }
    b = i;
  }
  return ({a, b}); // Returns ({3, 1})
```

--------------------------------

### Generate Pixel with Color Name (Roxen)

Source: https://github.com/pikelang/roxen/blob/devel/server/config_interface/whatsnew.html

Generates a 1x1 pixel image with a specified color. The color can be defined by a symbolic name (e.g., 'darkgreen') or an RGB value (e.g., '0000ff'). This functionality is part of the internal Roxen server processing.

```Roxen
/internal-roxen-pixel-colorname
```

```Roxen
/internal-roxen-pixel-red
```

```Roxen
/internal-roxen-pixel-ff0000
```