Action Log - Quick Reference

/OpenForum/AddOn/ActionLog Sevice API Version 0.0.7

Get Actions

Action search

Parameters

Name	Description
actionType (required=false)	{{parameter.description}}
term (required=false)	{{parameter.description}}
fromTs (required=false)	{{parameter.description}}
toTs (required=false)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/ActionLog?action=search

Example Response

Example Error Response

Action getActionTypes

Parameters

Name	Description
(required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/ActionLog?action=getActionTypes

Example Response

Example Error Response

Post Actions

Action logAction

Parameters

Name	Description
actionType (required=true)	{{parameter.description}}
action (required=true)	{{parameter.description}}

Example Post Request

/OpenForum/AddOn/ActionLog?action=logAction

Example Response

Example Error Response

Monitor and alert on triggers, heartbeats, and alarms

Key Features

Three alert types: Triggers, Heart Beat monitors, and Alarms
Configurable alert and escalation times
Tag-based alert organization
State tracking (OK, Triggered, Escalated)
Web UI for alert management

Alert Types:

- - Trigger** - Fires when specific condition occurs

- Heart Monitor** - Monitors periodic heartbeat signals

- Alarm** - Time-based alarm notifications

Server-Side Usage: // Get the Alert API var Alert = js.getObject("/OpenForum/AddOn/Alert","Alert.sjs"); // Add an alert Alert.addAlert("ServerHealth", "heartMonitor", 60000, 300000); // Trigger an alert Alert.trigger("ServerHealth"); // Send heartbeat Alert.beat("ServerHealth"); // Get alerts by tag var alerts = Alert.getAlerts("production");

/OpenForum/AddOn/Alert Sevice API Version 1.0.7

Get Actions

Action getAlerts

Parameters

Name	Description
tag (required=false)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/Alert?action=getAlerts

Example Response

Example Error Response

Action addAlert

Parameters

Name	Description
name (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/Alert?action=addAlert

Example Response

Example Error Response

Action removeAlert

Parameters

Name	Description
name (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/Alert?action=removeAlert

Example Response

Example Error Response

Action triggerAlert

Parameters

Name	Description
name (required=true)	{{parameter.description}}
reason (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/Alert?action=triggerAlert

Example Response

Example Error Response

Action beatAlert

Parameters

Name	Description
name (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/Alert?action=beatAlert

Example Response

Example Error Response

Action cancelAlert

Parameters

Name	Description
name (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/Alert?action=cancelAlert

Example Response

Example Error Response

Action getAlert

Parameters

Name	Description
name (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/Alert?action=getAlert

Example Response

Example Error Response

Action getTags

Parameters

Name	Description
alertName (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/Alert?action=getTags

Example Response

Example Error Response

Post Actions

Quick Reference

Anonymous Session provides the ability to offer tokens to store assets against like Zoom call ids. You can also combine them with passwords as an extra security step.

Example Use

/OpenForum/AddOn/AnonymousSession?action=validateSession&key=3ACDC2D4

QuickReference

The barcode scanner makes use of the Quagga javascript library.

We have chosen to only capture EAN barcodes at present.

Quick Start Code

In your pages page.js file, include the barcode scanner script. If you want to keep a reference to your barcode scanner, add a variable to hold it.

OpenForum.includeScript("/OpenForum/AddOn/BarcodeScanner/BarcodeScanner.js"); var barcodeScanner;

Within your OpenForum init function, request a barcode scanner, passing it the element where you want the video feed to be displayed and the function you want called when a barcode has been detected.

If you want to keep a reference to your barcode scanner, add a callback function to recieve a reference to the created scanner.

The scanner will immediately start scanning for barcodes. When one is found, the callback function will be called passing in the code.

OpenForum.init = function() { BarcodeScanner.getScanner( document.getElementById("yourElement"), lookup, function(scanner) { barcodeScanner = scanner; });

Claude AI integration with Model Context Protocol (MCP) support

Key Features

MCP server and client implementation
Claude Desktop integration
AI context management
Message queue monitoring
Tool creation and management
Content generation support
Giraffe.js graphics library integration

Server-Side Usage: // Get ClaudeMCP API var ClaudeMCP = js.getObject("/OpenForum/AddOn/ClaudeMCP","ClaudeMCP.sjs"); // Work with MCP tools and contexts Key Resources

Use Cases

AI-powered automation
Content generation
Interactive AI tools
Graphics creation

See main ClaudeMCP Hub for full documentation

Content Editor - Quick Reference

The content editor is a two panel editor. It is intended for pages that just contain text and images rather than those that are part of a web application.

Editor Panels

The two panels can be resized by dragging the separator between them.

The left hand panel gives an over view of the page being edited at the top, a list of pages to edit in the middle and a view of the image library at the bottom.

The right hand panel gives a view of the page content for editing. At the top is the title as shown on the browser tab and below are the sections of the page.

Adding Blocks

Above and below each page section are + buttons that will add content either above or below existing elements of content. There are also up and down buttons to move the content up and down the sections in the page.

On clicking + you are presented with a list of blocks that can be added to the page.

For simple formatted text and images, the WYSIWYG block allows you to enter text and type set it adding text styles, links and lists etc.

Images

To add an image into the WYSIWYG panel, find the image in the image library in the left hand pane or select to upload one. Drag the image into the WYSIWYG content block. Click on it to set any alternative text or its placement in the text.

A number of other block types are available that add either configurable page elements or page layouts.

Preview and Publish

To see how your page will look once published, click on Preview at the top of the left hand pane. This will save the page to a space for unpublished pages and make the page visible in another browser tab. Saving the page once the preview has been opened will automatically update the preview tab.

Once you are happy with your page, click Publish and the page will be published to the live area of your website.

New Pages

To create a new page select Create A New Page. In the popup window, enter the new pages title and optionally select a category. Select Create New Page and a new page will be added to the list and the editor for the page opened.

API Reference

ImageProcessor Quick Reference

Upload, process, and categorize images in OpenForum

Key Features

Batch image upload and processing
Automatic image categorization and tagging
Thumbnail generation
Image format conversion
EXIF data extraction
Organize images by category

Server-Side Usage: // Get the ImageProcessor API var ImageProcessor = js.getObject("/OpenForum/AddOn/ImageProcessor","ImageProcessor.sjs"); // Process uploaded image ImageProcessor.processImage("/MyPage", "image.jpg", { createThumbnail: true, maxWidth: 1024, category: "photos" }); // Generate thumbnail ImageProcessor.createThumbnail("/MyPage", "image.jpg", 200, 200); // Extract EXIF data var exif = ImageProcessor.getExifData("/MyPage", "image.jpg"); Client-Side Upload: // Upload and process image var formData = new FormData(); formData.append('image', fileInput.files<a href="/OpenForum/Editor?pageName=/OpenForum/AddOn/ImageProcessor/QuickReference/0"target="editor" style="color: red" title="The page /OpenForum/Editor?pageName=/OpenForum/AddOn/ImageProcessor/QuickReference/0 does not exist. Click to create it.">0</a>); formData.append('category', 'photos'); JSON.post('/OpenForum/AddOn/ImageProcessor/Upload', null, formData) .onSuccess(function(result) { console.log('Image processed:', result); }).go(); Configuration

Configure thumbnail sizes and quality
Set default image categories
Define processing rules and filters

MCP Service Tools Quick Reference

Comprehensive guide to MCP tools, prompts, and resources for OpenForum integration

This reference provides detailed documentation for all available MCP (Model Context Protocol) tools, prompts, and resources in the HomeLab MCP service environment. Each tool includes descriptions, parameters, usage examples, and integration patterns for seamless OpenForum development.

MCPClientTool

CLASSIFICATION: System Control Interface

FUNCTION: Initiate MCP client restart sequence to reload MCP configurations

DESCRIPTION: This tool provides programmatic control over the MCP client application lifecycle. When invoked, it triggers a clean restart of the MCP client environment, which forces a reload of all MCP tool definitions, prompts, and resources from their registry files. This is essential after creating new tools, modifying existing ones, or updating configuration files like tool-list.json. The optional prompt parameter allows you to request user confirmation before the restart occurs.

ACCESS PROTOCOL: Request "restart" or "reload MCP tools" via voice command

PARAMETERS:

prompt (boolean) - Enable confirmation dialog before system restart

restart MCP client

restart with confirmation prompt

MCPDevTool

CLASSIFICATION: Development Environment

FUNCTION: Create, test, and deploy new MCP tools within the system matrix

DESCRIPTION: A comprehensive development toolkit for building and managing MCP tools in the OpenForum environment. This meta-tool streamlines the entire development lifecycle by providing commands to create new tool files from templates, validate JavaScript syntax, register tools in the tool-list.json registry, and browse the tool directory structure. It eliminates manual file manipulation and reduces errors by automating the deployment process. The tool also provides direct access to read existing tool source code and restart MCP client to test newly created or modified tools.

ACCESS PROTOCOL: Development workflow for MCP tool creation

AVAILABLE OPERATIONS:

create - Instantiate new tool from source code
test - Execute syntax validation protocols
deploy - Integration with tool-list.json registry
list - Display all available system tools
read - Access tool source code
restart - Reload MCP client matrix
template - Retrieve tool construction template
listfiles - Browse directory matrix structures

create a new MCP tool for file processing

test the syntax of MyNewTool

deploy the DatabaseTool to the tool list

JavaTool

CLASSIFICATION: Code Compilation Matrix

FUNCTION: Compile and execute Java code, run Maven build protocols

DESCRIPTION: A full-featured Java development environment that bridges MCP service with Java compilation and execution capabilities. This tool handles both standalone Java file compilation using javac and comprehensive Maven project management including building, testing, packaging, and executing Java applications. It manages classpaths, working directories, and command-line arguments automatically. Perfect for rapid prototyping, testing Java snippets, running Maven builds, executing test suites, and creating new Maven projects with specified group and artifact IDs. The tool captures both standard output and error streams to provide complete feedback on compilation and execution results.

ACCESS PROTOCOL: Java development and testing environment

AVAILABLE OPERATIONS:

compile_java - Compile .java source files
run_java - Execute compiled Java classes
compile_and_run - Combined compilation and execution
maven_compile - Maven compilation phase
maven_test - Execute Maven test suite
maven_package - Generate Maven package
maven_clean - Clean Maven project artifacts
maven_exec - Execute Java main class
create_maven_project - Initialize new Maven project

compile and run my HelloWorld.java file

run Maven tests on my project

Structured conversation initiators with expert guidance protocols for specific domains.

MCP Tool Developer

CLASSIFICATION: Development Assistant Protocol

FUNCTION: Expert guidance for MCP tool development

DESCRIPTION: An AI-powered expert assistant prompt that provides specialized guidance throughout the MCP tool development process. When activated, MCP service assumes the role of an experienced MCP developer who can help design tool architectures, write clean JavaScript code for OpenForum integration, debug issues, suggest best practices, and explain MCP protocol specifications. This prompt is particularly valuable for understanding the nuances of tool parameter definitions, error handling patterns, and OpenForum helper class usage.

ACCESS PROTOCOL: "Use the MCP tool developer prompt to help me..."

PARAMETERS:

tool_type (optional) - Specify tool category
complexity (optional) - Define complexity level
specific_help (optional) - Target assistance area

use the MCP tool developer prompt to create a file processor

Java Code Reviewer

CLASSIFICATION: Code Analysis Protocol

FUNCTION: Expert Java code review and optimization recommendations

DESCRIPTION: A specialized code review prompt that transforms MCP service into an expert Java code reviewer with deep knowledge of best practices, design patterns, performance optimization, and common pitfalls. When invoked, this prompt enables comprehensive analysis of Java code including style consistency, potential bugs, security vulnerabilities, performance bottlenecks, and architectural improvements. It can focus on specific aspects like thread safety, memory management, or Java version-specific features based on your requirements.

ACCESS PROTOCOL: "Use the Java code reviewer prompt to..."

PARAMETERS:

review_focus (optional) - Specify review focus area
code_complexity (optional) - Define code complexity level
java_version (optional) - Target Java version

use the Java code reviewer prompt for performance review

Data source access points, file systems, and system information repositories.

Tool Directory

URI: openforum://OpenForum/AddOn/MCPService/tools

CLASSIFICATION: File System Browser

FUNCTION: Browse MCP tool files and configuration matrices

DESCRIPTION: A dynamic resource that provides real-time inventory of all MCP tools in the system. When accessed, it scans the OpenForum/AddOn/MCPService directory for .sjs tool files, cross-references them with tool-list.json, and returns detailed metadata including file sizes, modification dates, registration status, and tool descriptions. This resource is invaluable for system auditing, discovering available tools, and identifying orphaned or unregistered tools that may need attention.

DATA FORMAT: JSON metadata with tool information, file statistics, and registry status

show me what MCP tools are available

System Logs

URI: openforum://system/logs

CLASSIFICATION: System Monitoring Interface

FUNCTION: Access system logs and MCP interaction history

DESCRIPTION: A comprehensive logging resource that aggregates system events, MCP tool invocations, error messages, and server activity into a readable format. It provides insight into what tools have been called, when they were executed, what errors occurred, and overall system health. Essential for troubleshooting tool failures, monitoring system performance, and understanding the flow of MCP communications between MCP service and the OpenForum server.

DATA FORMAT: Server status reports, recent events, error summaries

check the system logs for any errors

Project Files

URI: openforum://projects/files

CLASSIFICATION: Project Analysis System

FUNCTION: Browse and analyze project files across development workspace

DESCRIPTION: A workspace analysis resource that scans configured project directories and generates comprehensive summaries including file counts, directory structures, programming language distributions, and project statistics. It helps MCP service understand your project landscape without manually exploring the filesystem. Useful for project overviews, identifying codebases to work with, and getting quick insights into project composition and organization.

DATA FORMAT: Project summaries, file statistics, directory structures

show me what projects are available

Tool Development Workflow

create a new MCP tool for database queries

test the syntax of my DatabaseTool

add DatabaseTool to the tool list

restart MCP client to load new tools

Java Development Workflow

Write Java code in your development environment
Execute: "compile my Java project"
Execute: "run Maven tests"
Use Java code reviewer prompt for guidance

System Monitoring Protocol

read the tool directory resource

check system logs for errors

list all available MCP tools

tool-list.json

CLASSIFICATION: Tool Registry Database

FUNCTION: Defines available MCP tools in the system matrix

{
  "toolName": {
    "pageName": "/OpenForum/AddOn/MCPService",
    "fileName": "ToolName.sjs"
  }
}

prompt-list.json

CLASSIFICATION: Prompt Registry Database

FUNCTION: Defines available MCP prompts in the system

{
  "promptName": {
    "pageName": "/OpenForum/AddOn/MCPService", 
    "fileName": "PromptName.sjs"
  }
}

resource-list.json

CLASSIFICATION: Resource Registry Database

FUNCTION: Defines available MCP resources in the system

{
  "resourceName": {
    "pageName": "/OpenForum/AddOn/MCPService",
    "fileName": "ResourceName.sjs"
  }
}

MCP Protocol

VERSION: 2024-11-05
TRANSPORT: OpenForum JavaScript server
CAPABILITIES: tools, prompts, resources (all with listChanged: true)

File System Locations

SERVER ROOT: /web/content/default/OpenForum/AddOn/MCPService/
TOOLS: *.sjs files + tool-list.json
PROMPTS: *Prompt.sjs files + prompt-list.json
RESOURCES: *Resource.sjs files + resource-list.json

OpenForum Integration

FILE HELPER: file.getFileAsString(), file.saveStringToFile()
JAVASCRIPT HELPER: js.getObject() for dynamic loading
PROCESS HELPER: Execute system commands
SERVER ROOT: All paths relative to /web/content/

Common System Errors

TOOL NOT FOUND: Verify tool-list.json and restart MCP client

SYNTAX ERRORS: Use MCPDevTool test action to validate code

FILE PERMISSIONS: Ensure OpenForum has read/write access

JAVA COMPILATION: Check classpath and file path configurations

Debugging Procedures

LOGS: Read system logs resource for MCP activity analysis
TOOL STATUS: Use MCPDevTool list action for inventory
FILE BROWSER: Use MCPDevTool listfiles action for directory inspection
ERROR FILES: Check for error-*.json files in MCP service directory

Tool Development Guidelines

Follow naming conventions (ToolName.sjs)
Include comprehensive error handling
Use OpenForum helper classes
Execute thorough testing before deployment
Document all parameters and usage patterns

Usage Optimization

Be specific in requests ("compile MyClass.java" vs "compile Java")
Use prompts for structured guidance protocols
Check resources for system status monitoring
Restart after configuration changes

Documentation Version: 1.0.0

MCP Server: OpenForum JavaScript Server

Last Updated: Generated dynamically from active tool registry

Support: For issues or questions, consult the MCP Tools Guide

Mailer Quick Reference

Notes

MemberServices Quick Reference

User authentication, registration, and member management system

Key Features

User registration and login
Password management and reset
Email verification
Member profile management
Role-based access control
Session management
Remember me functionality

Server-Side Usage: // Get the MemberServices API var MemberServices = js.getObject("/OpenForum/AddOn/MemberServices","MemberServices.sjs"); // Register new member MemberServices.register("username", "email@example.com", "password"); // Authenticate user var authenticated = MemberServices.authenticate("username", "password"); // Get member details var member = MemberServices.getMember("username"); // Update member profile MemberServices.updateProfile("username", { email: "newemail@example.com", displayName: "Display Name" }); // Check if user has role var hasRole = MemberServices.hasRole("username", "admin"); Client-Side Usage: // Login JSON.post('/OpenForum/AddOn/MemberServices/Login', null, 'username=myuser&password=mypass') .onSuccess(function(result) { console.log('Logged in:', result); }).go(); // Register JSON.post('/OpenForum/AddOn/MemberServices/Register', null, 'username=newuser&email=user@example.com&password=pass123') .onSuccess(function(result) { console.log('Registered:', result); }).go(); // Get current user JSON.get('/OpenForum/AddOn/MemberServices/CurrentUser') .onSuccess(function(user) { console.log('Current user:', user); }).go(); Configuration

Email verification settings
Password strength requirements
Session timeout configuration
Default roles for new members

Menu Editor - Quick Reference

A menu bar editor.

QuickReference

(

Publisher promotes any /... page hierarchy to production by copying it without the /Development prefix so work-in-progress stays isolated.

Every text-based attachment is rewritten so `"/"` links become live paths, and optional rules in `development-translation.sjs` can further transform each file.

Practice publishes generate release notes plus a deletions script preview without touching the live site; the real publish copies files and appends removal commands into `process-deletions.sjs` for manual execution.

Actions

Check for Page Differences – Compares timestamps and hashes between the /Development tree and its published counterpart so you can see what will change.
Reverse Publish – Copies the published page back into /Development to recover live edits or restart from a known-good state.
Publish Page (practice) – Runs the full translation/diff pipeline, writes detailed release notes, but skips copying so you can verify the impact.
Publish Page (for real) – Performs the same checks and then copies the files, applies path rewrites, generates release notes, and refreshes the published page.

Special files

development-translation.sjs – Optional script invoked per text file; receives the file contents as `data` and must return the transformed string.
publish-config.json – JSON blob for exclusions, e.g. `{"excludedFiles":"do-not-publish.me"}`; also expands the standard exclusion list.
do-not-release.txt – Presence blocks publishing and should describe why the page is locked.
process-deletions.sjs – Auto-generated script listing live files to delete after you verify them; run manually once you are satisfied.
release-notes.html.fragment – Captures the accordion-style log of each publish run for auditing.

Usage tips

Publish from the root /... page you want to release; sub pages are handled automatically.
Always inspect the practice-mode release notes before running the real publish so you catch unexpected deletions or TODO markers.
Keep the generated deletions script in source control (or review it) before executing so you have an audit trail of removed files.

Generator

Include script: } Function to generate 3 sizes of QR Code }

Scanner

Include script: OpenForum.includeScript("/OpenForum/AddOn/QRCode/Scanner/qr-code-scanner.js"); Create required variables: var qrCodeScanner; var qrcode = { data: "", timeStamp: "", error: true }; Create the scanner and add a listener: OpenForum.init = function() { qrCodeScanner = new QRCodeScanner(); qrCodeScanner.addListener( function( newQR ) { qrcode = newQR; } ); };

Released Packages - Quick Reference

The Release AddOn enables the releaseing of packages for use on other sites.

Special files

pre-release.sjs - This script is run on the releasing server before the release package is built
release-excludes-files.json - A list of files to exclude from the release. This can include regex like .*-test.js
release-info.json - Contains release information
install.sjs - Run on the server where the package is installed after the package has been installed

RemoteLogger Quick Reference

Centralized logging system for collecting logs from remote OpenForum servers

Key Features

Collect logs from remote servers
Centralized log aggregation
Remote error tracking
Log filtering and search
Real-time log streaming
Log level management
Multi-server log consolidation

Server-Side Usage: // Get the RemoteLogger API var RemoteLogger = js.getObject("/OpenForum/AddOn/RemoteLogger","RemoteLogger.sjs"); // Send log to remote logger RemoteLogger.log("INFO", "My log message"); RemoteLogger.error("Error message"); RemoteLogger.warn("Warning message"); RemoteLogger.debug("Debug message"); // Log with context RemoteLogger.log("INFO", "User action", { user: "username", action: "login", timestamp: new Date().getTime() }); // Get logs var logs = RemoteLogger.getLogs({ level: "ERROR", startTime: startTimestamp, endTime: endTimestamp }); Client-Side Usage: // Send log message JSON.post('/OpenForum/AddOn/RemoteLogger/Log', null, 'level=INFO&message=' encodeURIComponent('Log message')) .onSuccess(function(result) { console.log('Log sent'); }).go(); // Get logs JSON.get('/OpenForum/AddOn/RemoteLogger/Get', null, 'level=ERROR&limit=100') .onSuccess(function(logs) { console.log('Logs:', logs); }).go(); Log Levels

DEBUG - Detailed debugging information
INFO - General informational messages
WARN - Warning messages
ERROR - Error messages
FATAL - Critical error messages

Configuration

Remote logger endpoint URL
Log level filtering
Log retention period
Maximum log size
Authentication credentials

QuickReference

Server Side

Include DB.sjs on your sjs file

var DB = js.getObject("/OpenForum/AddOn/SQL","DB.sjs"); DB.setAlias("your database name"); // Create a new DB object for each database you need access to

Create a Simple DB Select

var sql = { action: "select", table: "my_table", columns: <a href="/OpenForum/Editor?pageName=/OpenForum/AddOn/SQL/QuickReference/ "column_a", "column_b" "target="editor" style="color: red" title="The page /OpenForum/Editor?pageName=/OpenForum/AddOn/SQL/QuickReference/ "column_a", "column_b" does not exist. Click to create it."> "column_a", "column_b" </a> }; var rows = DB.execute( SQL );

Create a DB Select that returns all columns

var sql = { action: "select", table: "my_table" }; var rows = DB.execute( SQL );

Create a Simple DB Insert

var sql = { action: "insert", table: "my_table", data: { column_a: "value a", column_b: "value b" } }; DB.execute( SQL );

Create a Simple DB Insert that returns a column

var sql = { action: "insert", table: "my_table", data: { column_a: "value a", column_b: "value b" }, returnColumn: "column_c" }; var returnedColumn = DB.execute( SQL );

Create a Simple DB Delete

var sql = { action: "delete", table: "my_table", where: { column_a: "value a", column_b: "value b" } }; DB.execute( SQL );

Create a Simple DB Upsert

var sql = { action: "upsert", table: "my_table", data: { column_a: "value a", column_b: "value b", column_c: "value c", column_d: "value d" }, where: { column_a: "value a", column_b: "value b" } }; DB.execute( SQL );

Create a Simple DB Query

var sql = { query: "select column_c, column_d from my_table where a = { {valueA} } and b = { {valueB} } data: { valueA: "value a", valueB: "value b" } }; DB.execute( SQL );

TileViewer Quick Reference

Canvas-based tile map viewer and renderer

Key Features

Display tile-based maps
Canvas rendering
Tile set management
Zoom and pan controls
Layer support
Custom tile rendering
Map data loading

Server-Side Usage: // Get the TileViewer API var TileViewer = js.getObject("/OpenForum/AddOn/TileViewer","TileViewer.sjs"); // Save tile map data TileViewer.saveTileMap("/MyPage", "map.json", mapData); // Load tile map var map = TileViewer.loadTileMap("/MyPage", "map.json"); // Save tile set TileViewer.saveTileSet("/MyPage", "tileset.json", tileSetData); Client-Side Usage: // Load tile map JSON.get('/OpenForum/AddOn/TileViewer/LoadMap', null, 'pageName=/MyPage&fileName=map.json') .onSuccess(function(mapData) { console.log('Map loaded:', mapData); renderMap(mapData); }).go(); // Save tile map JSON.post('/OpenForum/AddOn/TileViewer/SaveMap', null, 'pageName=/MyPage&fileName=map.json&data=' JSON.stringify(mapData)) .onSuccess(function(result) { console.log('Map saved'); }).go(); Map Data Format { width: 20, height: 15, tileSize: 32, layers: <a href=" { name: "ground", tiles: <div class="panel callout radius"></div>,1,2,3..." target="external_page"> { name: "ground", tiles: <div class="panel callout radius"></div>,1,2,3...</a>, <a href="/OpenForum/Editor?pageName=/OpenForum/AddOn/TileViewer/QuickReference/1,2,3,4..."target="editor" style="color: red" title="The page /OpenForum/Editor?pageName=/OpenForum/AddOn/TileViewer/QuickReference/1,2,3,4... does not exist. Click to create it.">1,2,3,4...</a>, ...] } ], tileset: "tileset.png" } Configuration

Canvas size
Tile dimensions
Default tile set
Rendering options

/OpenForum/AddOn/Update Sevice API Version 0.1.9

Get Actions

Action getUpdate

Parameters

Name	Description
pageName (required=true)	{{parameter.description}}
ignoreChanges (required=false)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/Update?action=getUpdate

Example Response

Example Error Response

Action getUpdateInfo

Parameters

Name	Description
pageName (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/Update?action=getUpdateInfo

Example Response

Example Error Response

Action getReleases

Parameters

Name	Description

Example Get Request

/OpenForum/AddOn/Update?action=getReleases

Example Response

Example Error Response

Post Actions

Action upsertToJSONList

Parameters

Name	Description
row (required=true)	{{parameter.description}}
indexName (required=true)	{{parameter.description}}
pageName (required=true)	{{parameter.description}}
fileName (required=true)	{{parameter.description}}

Example Post Request

/OpenForum/AddOn/Update?action=upsertToJSONList

Example Response

Example Error Response

Quick Reference

Adds user feedback buttons to a page.

text - optional text to display in front of buttons

<script> var pageLikes = {likes: "", dislikes: ""}; OpenForum.includeScript("/OpenForum/AddOn/UserFeedback/UserFeedbackClient.js"); OpenForum.includeScript("/OpenForum/AddOn/UserFeedback/user-feedback.js"); </script> <span id="userFeedback" style="display: none;"> Some text to show <a href="#" onclick="UserFeedback.thumbsUp();"><img src="/OpenForum/AddOn/UserFeedback/thumb-up.png" width="32" height="32"/></a> {{pageLikes.likes}} <a href="#" onclick="UserFeedback.thumbsDown();"><img src="/OpenForum/AddOn/UserFeedback/thumb-down.png" width="32" height="32"/> </a> {{pageLikes.dislikes}} <a style="font-size: 10px; border-radius: 5px; margin: 0px; padding: 5px; background-color: #2ba6cb; border-color: #2285a2; color: #ffffff;" onClick="UserFeedback.showSendFeedback('text');">Send Feedback</a> </span> <div id="userFeedbackModal" class="reveal-modal" data-reveal aria-labelledby="firstModalTitle" aria-hidden="true" role="dialog"> <h2>Send Feedback {{UserFeedback.icon}}</h2> <p><textarea of-id="UserFeedback.text" cols="120" rows="3" maxlength="250"></textarea></p> <p>Please contact me at email address <input type="text" of-id="UserFeedback.email"/></p> <p><a href="#" onClick="UserFeedback.sendFeedback();return false;" class="success button">Send Feedback</a></p> <a class="close-reveal-modal" aria-label="Close">×</a> </div>

WorkQueue Quick Reference

--8<--
An implementation of Work Queues to manage tasks that need to be processed sequentially.
-->8--

/OpenForum/AddOn/WorkQueue Sevice API Version 0.1.5

Get Actions

Action addItemToQueue

Parameters

Name	Description
name (required=true)	{{parameter.description}}
status (required=true)	{{parameter.description}}
slaTime (required=true)	{{parameter.description}}
data (required=true)	{{parameter.description}}
queue (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/WorkQueue?action=addItemToQueue

Example Response

Example Error Response

Action getQueues

Parameters

Name	Description

Example Get Request

/OpenForum/AddOn/WorkQueue?action=getQueues

Example Response

Example Error Response

Action getItemsOnQueue

Parameters

Name	Description
queue (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/WorkQueue?action=getItemsOnQueue

Example Response

Example Error Response

Action getItemOnQueue

Parameters

Name	Description
queue (required=true)	{{parameter.description}}
itemId (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/WorkQueue?action=getItemOnQueue

Example Response

Example Error Response

Action moveItemToQueue

Parameters

Name	Description
fromQueue (required=true)	{{parameter.description}}
itemId (required=true)	{{parameter.description}}
toQueue (required=)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/WorkQueue?action=moveItemToQueue

Example Response

Example Error Response

Action setItemStatus

Parameters

Name	Description
status (required=true)	{{parameter.description}}
itemId (required=true)	{{parameter.description}}
queue (required=)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/WorkQueue?action=setItemStatus

Example Response

Example Error Response

Action setItemData

Parameters

Name	Description
queue (required=true)	{{parameter.description}}
itemId (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/WorkQueue?action=setItemData

Example Response

Example Error Response

Action setItemCompleted

Parameters

Name	Description
queue (required=true)	{{parameter.description}}
itemId (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/WorkQueue?action=setItemCompleted

Example Response

Example Error Response

Action setItemFailed

Parameters

Name	Description
queue (required=true)	{{parameter.description}}
itemId (required=true)	{{parameter.description}}

Example Get Request

/OpenForum/AddOn/WorkQueue?action=setItemFailed

Example Response

Example Error Response

Post Actions

Action addItemToQueue

Parameters

Name	Description
name (required=true)	{{parameter.description}}
status (required=true)	{{parameter.description}}
slaTime (required=true)	{{parameter.description}}
data (required=true)	{{parameter.description}}
queue (required=true)	{{parameter.description}}

Example Post Request

/OpenForum/AddOn/WorkQueue?action=addItemToQueue

OpenForum Add Ons

ActionLog

Alert

AnonymousSession

Audio

AudioMonitor

AudioNotePad

AudioRecorder

BarcodeScanner

Calendar

ClaudeMCP

ContentEditor

DataLogger

Developer

DocumentGenerator

ImageProcessor

LeafetMap

MCPService

Mailer

Notes

MemberServices

MenuEditor

Publisher

QRCode

Generator

RSSRenderer

ReleasedPackages

RemoteAdministration

RemoteLogger

SQL

ServiceBuilder

SiteMapBuilder

Spider

TileViewer

Update

UserFeedback

WorkQueue