FoolFuuka

FoolFuuka is a software package designed for two primary purposes:

1. Image-based bulletin board software: Functions as a platform for image-centric discussion boards.
2. Asagi front-end interface: Provides a functional front-end interface for Asagi.

Detailed documentation for installation and usage can be found at the official Read the Docs site.

http://foolfuuka.rtfd.org/

The Chan controller uses a routing pattern where methods prefixed with radix_ are called when a radix (a board or archive) is identified in the request attributes via radix_shortname.

Common radix-prefixed actions include:

• radix_page($page): Displays the board/archive page with a specific pagination.
• radix_thread($num): Displays a specific thread by its number.
• radix_gallery($page): Displays an image gallery for the radix.
• radix_post($num): Redirects or displays a specific post.
• radix_search(): Performs a search scoped to the current radix.
• radix_image(): Handles image hash lookups.
• radix_last($limit, $num): Fetches the last X posts.

The Media class is the primary model for managing media files and their associated database records in FoolFuuka. It handles file uploads, thumbnail generation, banning, and link generation. It is typically instantiated via a CommentBulk object which provides the context of the media (e.g., whether it belongs to an opening post or a reply) and its associated Radix (board).

Key capabilities include:

• Link Generation: Retrieve full media links, thumbnail links, or download links.
• File Management: Delete files, ban media globally or per-board, and manage file paths.
• Upload Processing: Insert new media files, generate thumbnails, and handle duplicate detection.
• Status Management: Check if media is STATUS_NORMAL, STATUS_BANNED, STATUS_FORBIDDEN, or STATUS_NOT_AVAILABLE.

The Comment model supports both standard and secure tripcodes extracted from the name field.

• Standard Tripcode: Generated using a salt derived from the plain text. It is prefixed with !.
• Secure Tripcode: Generated using a SHA1 hash combined with a salt defined in the project configuration (foolz/foolfuuka -> config -> comment.secure_tripcode_salt). It is prefixed with !!.

When a name contains a # (e.g., Name#trip), the model automatically parses it into a separate name and trip property.

The application entrypoint sets up error reporting for development. For production environments, you should modify the error_reporting and display_errors settings to prevent leaking sensitive information.

error_reporting(-1);
ini_set('display_errors', 1);

The Font Awesome assets included in this theme use the following licenses:

• Font Files: SIL Open Font License
• CSS, LESS, and SASS files: MIT License
• Pictograms: CC BY 3.0 License

While attribution is no longer required in version 3.0, it is appreciated: Font Awesome by Dave Gandy - http://fortawesome.github.com/Font-Awesome.

Use setOptions() to pass configuration parameters to the Board's fetching and counting methods. You can pass a single key-value pair or an associative array to set multiple options at once. These options (such as page, per_page, or type) are used internally by the model to shape database queries.

// Set a single option
$board->setOptions('per_page', 20);

// Set multiple options via an associative array
$board->setOptions([
    'page' => 1,
    'per_page' => 50,
    'order' => 'by_post'
]);

If the authenticated user has the comment.reports permission, you can retrieve reports associated with a comment or its media using getReports().

This method checks both the comment's doc_id and, if media is attached, the media_id to aggregate all relevant reports.

$reports = $commentModel->getReports();

Use the following methods to retrieve URLs for media files. Most methods require a Symfony�Component�HttpFoundation�Request object to handle protocol (HTTP/HTTPS) and CDN logic.

• getMediaLink(Request $request): Returns the URL for the full media file.
• getThumbLink(Request $request): Returns the URL for the thumbnail.
• getMediaDownloadLink(Request $request): Returns a direct download link (if configured in preferences).
• getRemoteMediaLink(Request $request): Returns a remote URL if the media is hosted externally (e.g., in an archive).