BZFlag Asset Manager

Asset Manager is a web interface for the submission of game assets and a simple moderation system. This is a replacement for the old BZFlag Image Uploader a.k.a. submitimages.

Feature Progress

• BZFlag WebLogin integration
• Queue database
• Image thumbnail generator
• Ability to upload new assets
  • Editing asset information after a change is requested
• Moderation interface for the asset queue
• Email notifications
  • Moderation queue reminders
• Directory index for listing assets

Requirements

• PHP 8.2 or later (ideally the FPM variant), with the following extensions:
  • PDO
  • cURL
  • FileInfo
  • GD
  • PDO
  • SQLite3
• Composer

Installation

This assumes that the website will be stored in /var/www/asset-manager, where /var/www/asset-manager/README.md would be this file.

git clone https://github.com/BZFlag-Dev/asset-manager /var/www/asset-manager
cd /var/www/asset-manager
composer install

The final location of approved assets would be elsewhere, such as /var/www/assets/public.

A configuration file named config.php will need to be created and would be placed at /var/www/asset-manager/config.php:

<?php
return [
  'site' => [
    'takedown_address' => '[email protected]'
  ],
  'path' => [
    'files' => '/var/www/assets/public'
  ],
  'auth' => [
    'admin_group' => 'SOME.GROUP',
  ],
  'asset' => [
    'upload' => [
      'types' => [
        'image/png' => 'png',
        'image/jpeg' => ['jpg', 'jpeg']
      ]
    ]
  ],
  'email' => [
    'from_address' => '[email protected]',
    'notify_addresses' => [
      '[email protected]',
      '[email protected]'
    ]
  ]
];

Create a symbolic link to directory_index.php inside /var/www/assets/public:

ln -s /var/www/asset-manager/directory_index.php /var/www/assets/public/index.php

Create a web server configuration, such as something like this for Apache:

<VirtualHost *:80>
        ServerName assets.example.com

        DocumentRoot /var/www/assets/public
        <Directory /var/www/assets/public>
                Require all granted
                DirectoryIndex /index.php
        </Directory>


        Alias /manage /var/www/asset-manager/public
        <Directory /var/www/asset-manager/public>
                Require all granted

                RewriteEngine On
                RewriteBase /manage
                RewriteCond %{REQUEST_FILENAME} !-f
                RewriteCond %{REQUEST_FILENAME} !-d
                RewriteRule ^ index.php [QSA,L]
        </Directory>
</VirtualHost>