Files
2025-12-19 19:04:57 -08:00

292 lines
8.9 KiB
PHP

<?php
/**
* @brief Field Model
* @author <a href='https://www.invisioncommunity.com'>Invision Power Services, Inc.</a>
* @copyright (c) Invision Power Services, Inc.
* @license https://www.invisioncommunity.com/legal/standards/
* @package Invision Community
* @subpackage Downloads
* @since 3 Oct 2013
*/
namespace IPS\downloads;
/* To prevent PHP errors (extending class does not exist) revealing path */
use IPS\Application;
use IPS\CustomField;
use IPS\Data\Store;
use IPS\Helpers\Form;
use IPS\Helpers\Form\Radio;
use IPS\Helpers\Form\TextArea;
use IPS\Helpers\Form\YesNo;
use IPS\Lang;
use IPS\Log;
use IPS\Member;
use IPS\Node\Permissions;
use IPS\Settings;
use IPS\Theme;
use ParseError;
use function defined;
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
{
header( ( $_SERVER['SERVER_PROTOCOL'] ?? 'HTTP/1.0' ) . ' 403 Forbidden' );
exit;
}
/**
* Field Node
*/
class Field extends CustomField implements Permissions
{
/**
* @brief [ActiveRecord] Multiton Store
*/
protected static array $multitons;
/**
* @brief [ActiveRecord] Database Table
*/
public static ?string $databaseTable = 'downloads_cfields';
/**
* @brief [ActiveRecord] Database Prefix
*/
public static string $databasePrefix = 'cf_';
/**
* @brief [Node] Order Database Column
*/
public static ?string $databaseColumnOrder = 'position';
/**
* @brief [CustomField] Column Map
*/
public static array $databaseColumnMap = array(
'not_null' => 'not_null'
);
/**
* @brief [Node] Node Title
*/
public static string $nodeTitle = 'ccfields';
/**
* @brief [CustomField] Title/Description lang prefix
*/
protected static string $langKey = 'downloads_field';
/**
* @brief [Node] Title prefix. If specified, will look for a language key with "{$key}_title" as the key
*/
public static ?string $titleLangPrefix = 'downloads_field_';
/**
* @brief [CustomField] Content Table
*/
public static string $contentDatabaseTable = 'downloads_ccontent';
/**
* @brief [CustomField] Set to TRUE if uploads fields are capable of holding the submitted content for moderation
*/
public static bool $uploadsCanBeModerated = TRUE;
/**
* @brief The map of permission columns
*/
public static array $permissionMap = array(
'view' => 'view',
'edit' => 2,
'add' => 3
);
/**
* @brief [Node] App for permission index
*/
public static ?string $permApp = 'downloads';
/**
* @brief [Node] Type for permission index
*/
public static ?string $permType = 'fields';
/**
* @brief [Node] Prefix string that is automatically prepended to permission matrix language strings
*/
public static string $permissionLangPrefix = 'perm_cfield_';
/**
* @brief [Node] ACP Restrictions
*/
protected static ?array $restrictions = array(
'app' => 'downloads',
'module' => 'downloads',
'prefix' => 'fields_',
);
/**
* @brief [CustomField] Editor Options
*/
public static array $editorOptions = array( 'app' => 'downloads', 'key' => 'Downloads' );
/**
* @brief [CustomField] FileStorage Extension for Upload fields
*/
public static string $uploadStorageExtension = 'downloads_FileField';
/**
* @brief [CustomField] An array of the 'keys' of the Field types toggles that shouldn't be an option. The main use is for excluding polls
*/
public static array $disabledFieldTypes = array( 'Poll' );
/**
* Get topic format
*
* @return string|null
*/
public function get_topic_format() : string|null
{
return $this->format;
}
/**
*
* [Node] Does the currently logged-in user have permission to edit permissions for this node?
*
* @return bool
*/
public function canManagePermissions() : bool
{
return true;
}
/**
* [Node] Add/Edit Form
*
* @param Form $form The form
* @return void
*/
public function form( Form &$form ) : void
{
parent::form( $form );
unset( $form->elements['']['pf_search_type'] );
unset( $form->elements['']['pf_search_type_on_off'] );
Member::loggedIn()->language()->words['field_displayoptions'] = Member::loggedIn()->language()->addToStack('pfield_displayoptions');
$form->add( new Radio( 'downloads_field_location', $this->id ? $this->display_location : 'below', FALSE, array( 'options' => array( 'sidebar' => 'idm_cfield_sidebar', 'below' => 'idm_cfield_below', 'tab' => 'idm_cfield_tab' ) ), NULL, NULL, NULL, 'idm_field_location' ) );
if ( Application::appIsEnabled( 'nexus' ) and Settings::i()->idm_nexus_on )
{
$form->add( new YesNo( 'downloads_field_paid', $this->id ? $this->paid_field : FALSE, FALSE, array( 'togglesOff' => array( 'idm_cf_topic', 'idm_pf_format', 'form_' . ( $this->id ?? 'new' ) . '_header_category_forums_integration' ) ) ) );
}
if ( Application::appIsEnabled( 'forums' ) )
{
$form->addHeader('category_forums_integration');
$form->add( new YesNo( 'cf_topic', $this->topic, FALSE, array(), NULL, NULL, NULL, 'idm_cf_topic' ) );
$form->add( new TextArea( 'pf_format', $this->id ? $this->topic_format : '', FALSE, array(), NULL, NULL, NULL, 'idm_pf_format' ) );
Member::loggedIn()->language()->words['pf_format_desc'] = Member::loggedIn()->language()->addToStack('cf_format_desc');
}
}
/**
* [Node] Format form values from add/edit form for save
*
* @param array $values Values from the form
* @return array
*/
public function formatFormValues( array $values ): array
{
if ( Application::appIsEnabled( 'forums' ) AND isset( $values['cf_topic'] ) )
{
/* Forcibly disable include in topic option if it is a paid field */
$values['topic'] = ( isset( $values['downloads_field_paid'] ) AND $values['downloads_field_paid'] ) ? 0 : $values['cf_topic'];
unset( $values['cf_topic'] );
}
$values['allow_attachments'] = $values['pf_allow_attachments'];
unset( $values['pf_search_type'] );
unset( $values['pf_allow_attachments'] );
$values['display_location'] = $values['downloads_field_location'];
$values['paid_field'] = ( isset( $values['downloads_field_paid'] ) ) ? $values['downloads_field_paid'] : 0;
unset( $values['downloads_field_location'], $values['downloads_field_paid'] );
return parent::formatFormValues( $values );
}
/**
* Get output for API
*
* @param Member|NULL $authorizedMember The member making the API request or NULL for API Key / client_credentials
* @param array $fieldValues Current values for a specific file
* @return array
* @apiresponse int id ID number
* @apiresponse string name Name
* @apiresponse string description Description
* @apiresponse string value Current value for this file
* @apiresponse string|int|array|boolean displayValue Parsed Field value with all field data
*/
public function apiOutput( ?Member $authorizedMember = NULL, array $fieldValues=array() ): array
{
$lang = $authorizedMember ? $authorizedMember->language() : Lang::load( Lang::defaultLanguage() );
return [
'id' => $this->id,
'name' => $lang->addToStack( 'downloads_field_' . $this->id ),
'description' => $lang->addToStack( 'downloads_field_' . $this->id . '_desc' ),
'value' => $fieldValues[ 'field_' . $this->id ] ?? null,
'displayValue' => $this->apiValue( $fieldValues[ 'field_' . $this->id ] )
];
}
/**
* Parse the HTML logic to format the field
*
* @param string $rawValue Raw value
* @param File $file
* @return string
*/
public function formatValue( string $rawValue, File $file ) : string
{
/* If we are using the "default" formatting, set that up now */
$template = $this->format ?: "<strong><span data-ips-font-size=\"90\">{title} </span></strong> {content}";
$template = str_replace( [ '{title}', '{content}' ], [ "{\$title}", "{\$content}" ], $template );
try
{
$functionName = 'downloadsfields_cc_' . md5( $template );
if ( ! isset( Store::i()->$functionName ) )
{
/* We need the "raw" content because HTML is typically used to format the value */
$template = str_replace( '{$processedContent}', '{$processedContent|raw}', $template );
/* If this an editor, we can safely use the |raw value as it is clean, otherwise the escaped value will display which is not what the user expects */
if ( $this->type == 'Editor' )
{
$template = str_replace( '{$content}', '{$content|raw}', $template );
$template = Theme::i()->getTemplate('global', 'core', 'global')->richText( $template );
}
/* $content is the raw content from the database, $processedContent is the parsed content ready for display */
Store::i()->$functionName = Theme::compileTemplate( $template, $functionName, '$title, $content, $processedContent, $file' );
}
Theme::runProcessFunction( Store::i()->$functionName, $functionName );
$themeFunction = 'IPS\\Theme\\'. $functionName;
return $themeFunction( Member::loggedIn()->language()->addToStack( static::$langKey . '_' . $this->id ), $rawValue, $this->displayValue( $rawValue ), $file );
}
catch ( ParseError $e )
{
@ob_end_clean();
Log::log( $e, 'pfield_error' );
return (string) $this->displayValue( $rawValue );
}
}
}