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

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

FileManager Quick Reference

Dual-filesystem manager for OpenForum - browser localStorage and server storage.

Overview

Manage files in both browser localStorage (browser://) and server filesystem (/OpenForum/Users/)
View, upload, download, rename, and delete files in both locations
Navigate folder hierarchies with expandable directory trees
Use standalone at /OpenForum/AddOn/FileManager or embed as a popup

Using the Standalone Page

Navigate to /OpenForum/AddOn/FileManager
Two panels display: Browser Filesystem (left) and Server Filesystem (right)
Click folders to expand/collapse; click files to see details and actions
Use buttons to create folders, upload files, and refresh listings

Browser Filesystem (LocalStorage)

Location: browser:// - stored in browser localStorage
Persistence: Stays local to your browser; not synced across devices
Capacity: Usually 5-10 MB per domain (browser-dependent)
Use cases: Client-side caching, offline drafts, temporary work
Actions: Create folders, upload files, download, rename, delete
Path format: browser://folderName/fileName.ext

Server Filesystem

Location: /OpenForum/Users/{username} on the server
Authentication: Requires login; guests see a sign-up prompt
Persistence: Permanent server storage; accessible from any device
Actions: Create folders, upload files, download, rename, delete
Path format: /OpenForum/Users/Admin/WorkSpace/file.txt

File Operations

Upload: Click "Upload File" button, then select file from your computer
Download: Click file to open popup, then click "Download" button
Rename: Click file to open popup, then click "Rename" button
Delete: Click file to open popup, then click "Delete" button (confirms before deletion)
Select: Click green "Select" button to use file in integrations

Folder Operations

Create folder: Click "New Folder" button and enter name
Expand/Collapse: Click ▶/▼ arrow next to folder name
Select folder: Click folder name (not arrow) to open folder actions popup
Upload to folder: In folder popup, click "Upload File Here"
Create subfolder: In folder popup, click "Create Subfolder"
Delete folder: In folder popup, click "Delete Folder" (confirms before deletion)

Integrating FileManager as a Popup

Embed FileManager in your own pages for file selection. See FileManagerPopupExample for complete code.

Basic Setup

// Include the FileManager script
OpenForum.includeScript("/OpenForum/AddOn/FileManager/file-manager.js");

// Create a popup container
var popup = document.createElement('div');
popup.className = 'file-manager-popup';
popup.id = 'fileManagerPopup';
popup.innerHTML =
  '<div class="file-manager-popup-content">' +
  '  <div id="popupFileManagerContainer"></div>' +
  '</div>';
document.body.appendChild(popup);

// Create FileManager instance
var popupFileManager = new FileManager();
popupFileManager.createView('popupFileManagerContainer');

// Handle file selection
popupFileManager.onFileSelected = function(filePath, isBrowser) {
  console.log('Selected:', filePath);
  // Your logic here
};

// Initialize
popupFileManager.init();

FileManager API

Creating an Instance

var fm = new FileManager();
fm.createView('containerId');  // Load UI into element
fm.init();                     // Initialize and render

Callback Properties

fm.onFileSelected = function(filePath, isBrowser) - Called when user clicks Select button
filePath - Full path like "browser://folder/file.txt" or "/OpenForum/Users/Admin/file.txt"
isBrowser - true for browser:// files, false for server files

Instance Methods

fm.refreshBrowserFiles() - Reload browser filesystem listing
fm.refreshServerFiles() - Reload server filesystem listing
fm.navigateBrowserTo(path) - Navigate to browser folder path
fm.navigateServerTo(path) - Navigate to server folder path

Multiple Instances

You can create multiple FileManager instances on the same page
Each instance is independent with its own state and callbacks
Example: One popup instance and one inline instance running simultaneously
Instance isolation ensures onclick handlers call the correct instance

Styling the Popup

Customize the popup appearance with CSS:

.file-manager-popup {
  position: fixed;
  top: 0; left: 0; right: 0; bottom: 0;
  background: rgba(0, 0, 0, 0.5);
  z-index: 2000;
  display: flex;
  align-items: center;
  justify-content: center;
}

.file-manager-popup-content {
  background: white;
  border-radius: 5px;
  padding: 20px;
  width: 90%;
  max-width: 1200px;
  height: 80%;
  overflow: auto;
}

Common Use Cases

File picker: Let users select a file from browser or server storage
Draft manager: Save work-in-progress to browser:// before server upload
Offline editing: Work with files in localStorage when offline
File browser: Browse and manage user workspace on server
Import/Export: Upload files to server or download for backup

Tips & Limitations

Browser storage limits: LocalStorage typically caps at 5-10 MB; use server for large files
Binary files: Currently text-based; binary file support may be limited
Path separators: Browser paths use / but don't require leading slash at root
Authentication: Server access requires login; browser access is always available
Clearing storage: Browser localStorage can be cleared by browser settings
File formats: All file types supported; .js, .json, .html, .xml, .txt tested extensively

Examples

Standalone FileManager - Full page with dual panels
Popup Example - Integration demo with popup and inline modes

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.

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 );

Tagging Quick Reference

Tag and categorize OpenForum pages for better organization and discovery

Key Features

Add tags to pages
List all tags
Find pages by tag
Tag cloud generation
Remove tags from pages
Tag management interface
Search by multiple tags

Server-Side Usage: // Get the Tagging API var Tagging = js.getObject("/OpenForum/AddOn/Tagging","Tagging.sjs"); // Add tag to page Tagging.addTag("/MyPage", "tutorial"); // Add multiple tags Tagging.addTags("/MyPage", <a href="/OpenForum/Editor?pageName=/OpenForum/AddOn/Tagging/QuickReference/"tutorial", "beginner", "javascript""target="editor" style="color: red" title="The page /OpenForum/Editor?pageName=/OpenForum/AddOn/Tagging/QuickReference/"tutorial", "beginner", "javascript" does not exist. Click to create it.">"tutorial", "beginner", "javascript"</a>); // Remove tag from page Tagging.removeTag("/MyPage", "tutorial"); // Get all tags for a page var tags = Tagging.getTags("/MyPage"); // Find pages with tag var pages = Tagging.findPagesWithTag("tutorial"); // Get all tags in system var allTags = Tagging.getAllTags(); // Get tag cloud (tags with counts) var tagCloud = Tagging.getTagCloud(); Client-Side Usage: // Add tag to page JSON.post('/OpenForum/AddOn/Tagging/Add', null, 'pageName=/MyPage&tag=tutorial') .onSuccess(function(result) { console.log('Tag added'); }).go(); // Get tags for page JSON.get('/OpenForum/AddOn/Tagging/Get', null, 'pageName=/MyPage') .onSuccess(function(tags) { console.log('Tags:', tags); }).go(); // Find pages by tag JSON.get('/OpenForum/AddOn/Tagging/Find', null, 'tag=tutorial') .onSuccess(function(pages) { console.log('Pages with tag:', pages); }).go(); // Get tag cloud JSON.get('/OpenForum/AddOn/Tagging/Cloud') .onSuccess(function(tagCloud) { console.log('Tag cloud:', tagCloud); }).go(); Tag Cloud Format <a href=" {tag: "tutorial", count: 15}, {tag: "javascript", count: 12}, {tag: "beginner", count: 8} " target="external_page"> {tag: "tutorial", count: 15}, {tag: "javascript", count: 12}, {tag: "beginner", count: 8} </a> Configuration

Tag storage location
Maximum tags per page
Tag naming conventions
Tag search 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

One Stone Soup

OpenForum Add Ons

ActionLog

Alert

ContentEditor

DataLogger

Developer

FileManager

ImageProcessor

MCPService

Mailer

Notes

MemberServices

MenuEditor

Publisher

ReleasedPackages

RemoteAdministration

RemoteLogger

SQL

ServiceBuilder

Tagging

Update