How to get custom Message fields across to recipient

[Bruk]

Hi. I know this question has been asked many times but there has been no clear guidance on how to resolve it.

Can you please provide the guidance on how to actually get the new custom field (subject in the case) across to the recipient. Pleas see the attached images for more detail (message form and message received on recipient end). The recipient doesn’t see the ‘subject’ of the message. Only the message text.

My existing code in functions.php is like the following:

// Form modification filter
add_filter(‘hivepress/v1/forms/message_send’, function($form) {
if (‘messages_view_page’ === hivepress()->router->get_current_route_name()) {
return $form;
}

// Add custom fields to the form
$form['fields']['subject'] = [
    'label'       => 'Subject',
    'type'        => 'text',
    'required'    => true,
    'min_length'  => 5,
    'max_length'  => 50,
    '_order'      => 1,
];

return $form;

});

I have the fields but the recipient ONLY gets the message. None of those additional fields including subject and name are seen by the recipient.

I have seen posts by hivepress team that message_text.php should be customized. I saw something about ‘tokens’ somewhere too. I know how to change templates but for this specific task, I’m in the tide and have tried many approaches to no avail. Please provide a solution that will work. Thank you.

P.S: I’m on experthive.

[andrii]

Hi,

If you are using our premium theme or extension, please add the license key in your forum profile settings, so we can provide general guidance.

[Bruk]

Hi @andrii. I have done so just now (adding the license key to profiles). Please notice this is my client’s site I’m working on. I’ll await your guidance. Thank you. As of the last request, I have made quite some progress on successfully sending custom fields to the recipient (see images for confirmation). And yet, upon these changes, the attachment from the front end user (after enabling message attachments in hivepress/settings/messages) attachment fails to be transferred. Without those custom additions, the attachment gets through to the recipient.

// child theme's functions.php

<?php

// Enqueue parent theme styles (keep this from your original code)
function experthive_child_enqueue_styles() {
    wp_enqueue_style( 'experthive-style', get_template_directory_uri() . '/style.css' );
    wp_enqueue_style( 'experthive-child-style', get_stylesheet_directory_uri() . '/style.css', array( 'experthive-style' ) );
}
add_action( 'wp_enqueue_scripts', 'experthive_child_enqueue_styles' );

// modifications to functions.php ()
add_filter('hivepress/v1/templates/message_send_form', function($template) {
    error_log('Message form template before modification: ' . print_r($template, true));
    
    // Set enctype directly if it exists as an individual parameter
    $template['enctype'] = 'multipart/form-data';

    error_log('Message form template after modification: ' . print_r($template, true));
    return $template;
}, 20);

// Debug the form generation
add_action('hivepress/v1/templates/message_send_form/render', function($output) {
    error_log('Form HTML output: ' . $output);
    return $output;
});

add_filter('hivepress/v1/configs/messages', function($config) {
    if (isset($config['settings']['messages_allow_attachments'])) {
        $config['settings']['messages_allow_attachments']['default'] = true;
    }
    return $config;
});

add_filter('hivepress/v1/forms/message_send', function($form) {
    // Don't modify the form in the messages view
    if ('messages_view_page' === hivepress()->router->get_current_route_name()) {
        return $form;
    }

    // Debug the original form structure
    error_log('Original form structure: ' . print_r($form, true));

    // Preserve and modify the attachment field
    if (isset($form['fields']['attachment'])) {
        $attachment_settings = $form['fields']['attachment'];
        
        // Force enable the attachment field
        unset($attachment_settings['disabled']);
        
        // Set required properties
        $attachment_settings['type'] = 'attachment_upload';
        $attachment_settings['multiple'] = false;
        $attachment_settings['required'] = false;
        $attachment_settings['formats'] = ['image/*', 'application/pdf']; // Adjust formats as needed
        $attachment_settings['_order'] = 60;
        
        // Remove the field and re-add it with new settings
        unset($form['fields']['attachment']);
        $form['fields']['attachment'] = $attachment_settings;
        
        error_log('Modified attachment settings: ' . print_r($attachment_settings, true));
    }

    // Add other custom fields
    $form['fields'] = array_merge($form['fields'], [
        'subject' => [
            'label'       => esc_html__('Subject', 'hivepress-messages'),
            'type'        => 'text',
            'required'    => true,
            'min_length'  => 5,
            'max_length'  => 50,
            '_order'      => 10,
        ],
        'sender_name' => [
            'label'       => esc_html__('Your Name', 'hivepress-messages'),
            'type'        => 'text',
            'required'    => true,
            '_order'      => 20,
        ],
        'sender_email' => [
            'label'       => esc_html__('Email Address', 'hivepress-messages'),
            'type'        => 'email',
            'required'    => true,
            '_order'      => 30,
        ],
        'sender_phone' => [
            'label'       => esc_html__('Phone Number', 'hivepress-messages'),
            'type'        => 'text',
            'required'    => true,
            '_order'      => 40,
        ],
        'quotation_amount' => [
            'label'       => esc_html__('Quotation Amount', 'hivepress-messages'),
            'type'        => 'number',
            'min_value'   => 0,
            'step'        => 'any',
            'required'    => true,
            '_order'      => 50,
        ],
    ]);

    return $form;
});

// Ensure the attachment field stays enabled
add_filter('hivepress/v1/forms/message_send/fields', function($fields) {
    if (isset($fields['attachment'])) {
        // Force enable the attachment field
        if (is_array($fields['attachment'])) {
            unset($fields['attachment']['disabled']);
        } elseif (is_object($fields['attachment'])) {
            $fields['attachment']->disabled = false;
        }
    }
    return $fields;
}, 999);

// Debug the form submission
add_action('init', function() {
    if (!empty($_POST) && isset($_POST['hp_form']) && $_POST['hp_form'] === 'message_send') {
        error_log('Form submission data:');
        error_log('POST: ' . print_r($_POST, true));
        error_log('FILES: ' . print_r($_FILES, true));
        
        // Check form attributes
        $html = ob_get_clean();
        if (strpos($html, 'enctype="multipart/form-data"') === false) {
            error_log('Form is missing multipart/form-data enctype');
        }
    }
});


// Debug HivePress attachment handling
add_action('hivepress/v1/models/message/create', function($message_id) {
    error_log('Message creation started - ID: ' . $message_id);
    
    // Check HivePress attachment handling
    if (method_exists('\HivePress\Models\Message', 'get_attachments')) {
        $message = new \HivePress\Models\Message($message_id);
        $attachments = $message->get_attachments();
        error_log('HivePress attachments: ' . print_r($attachments, true));
    }
    
    // Check if HivePress is using a different meta key for attachments
    $all_meta = get_comment_meta($message_id);
    error_log('All message meta: ' . print_r($all_meta, true));
}, 5);


// Debug early in the message creation process
add_action('hivepress/v1/models/message/create', function($message_id) {
    error_log('Message Creation Debug - Message ID: ' . $message_id);
    
    if (isset($_FILES['attachment'])) {
        error_log('Attachment data: ' . print_r($_FILES['attachment'], true));
    } else {
        error_log('No attachment found in $_FILES');
    }
    
    // Check if we're getting to the media upload
    add_filter('wp_handle_upload_prefilter', function($file) {
        error_log('Upload being attempted for file: ' . $file['name']);
        return $file;
    });
}, 5);

// Main message creation handler
add_action('hivepress/v1/models/message/create', function($message_id) {
    // Check if message_id is valid
    if (!$message_id || !is_numeric($message_id)) {
        error_log('Invalid message ID: ' . print_r($message_id, true));
        return;
    }

    // Array of fields to save
    $fields = [
        'subject',
        'sender_name',
        'sender_email',
        'sender_phone',
        'quotation_amount'
    ];

    // Save each field if it exists in POST data
    foreach ($fields as $field) {
        if (isset($_POST[$field])) {
            $value = sanitize_text_field($_POST[$field]);
            if (!empty($value)) {
                update_comment_meta($message_id, $field, $value);
                error_log("Saved field $field with value: $value");
            }
        }
    }

    // Handle file attachment
    if (isset($_FILES['attachment']) && !empty($_FILES['attachment']['name'])) {
        // Make sure we have the media handling functions
        require_once(ABSPATH . 'wp-admin/includes/image.php');
        require_once(ABSPATH . 'wp-admin/includes/file.php');
        require_once(ABSPATH . 'wp-admin/includes/media.php');
        
        // Log the attachment data
        error_log('Attempting to upload file: ' . print_r($_FILES['attachment'], true));
        
        // Let WordPress handle the upload
        $attachment_id = media_handle_upload('attachment', 0);
        
        if (is_wp_error($attachment_id)) {
            // Log error if upload fails
            error_log('Upload failed: ' . $attachment_id->get_error_message());
        } else {
            // Log success and attachment details
            error_log('Upload successful. Attachment ID: ' . $attachment_id);
            
            // Save the attachment ID to the message meta
            update_comment_meta($message_id, 'attachment_id', $attachment_id);
            
            // Log the saved meta
            error_log('Saved attachment meta for message ' . $message_id);
        }
    } else {
        error_log('No attachment found or attachment name is empty');
    }
}, 10);

// Debug HivePress message object
add_action('hivepress/v1/models/message/create', function($message_id) {
    // Check for HivePress-specific attachment handling
    if (class_exists('HivePress\Models\Message')) {
        $message = new \HivePress\Models\Message($message_id);
        error_log('HivePress Message Object: ' . print_r($message, true));
    }
}, 15);

The next code section is implemented on message-text.php file inside wp-content/plugins/hivepress-messages/templates/message/view. Ofcourse I tried it insteadon the child → wp-content/themes/experthive-child/templates/message/view/message-text.php but only the former helped in successfully sending those custom fields (subject, name, phone, …) to the recipient. Please see attached image for more details.

<?php
if (!defined('ABSPATH')) {
    exit;
}

// Get the message object safely
$message = isset($message) ? $message : null;
if (!$message) {
    return;
}

// Define the fields to display
$fields = [
    'subject' => esc_html__('Subject', 'hivepress-messages'),
    'sender_name' => esc_html__('Name', 'hivepress-messages'),
    'sender_email' => esc_html__('Email', 'hivepress-messages'),
    'sender_phone' => esc_html__('Phone', 'hivepress-messages'),
    'quotation_amount' => esc_html__('Quotation Amount', 'hivepress-messages'),
];
?>

<div class="hp-message__text">
    <div class="hp-message__details">
        <?php 
        foreach ($fields as $field_key => $field_label):
            $field_value = get_comment_meta($message->get_id(), $field_key, true);
            if (!empty($field_value)):
        ?>
            <div class="hp-message__detail-item">
                <span class="hp-message__detail-label"><?php echo esc_html($field_label); ?>:</span>
                <span class="hp-message__detail-value">
                    <?php 
                    if ($field_key === 'quotation_amount') {
                        echo esc_html(number_format((float)$field_value, 2));
                    } else {
                        echo esc_html($field_value);
                    }
                    ?>
                </span>
            </div>
        <?php 
            endif;
        endforeach;
        ?>
    </div>
    
    <div class="hp-message__content">
        <?php echo wp_kses_post($message->get_text()); ?>
    </div>

    <?php
    // Display attachment if exists
    $attachment_id = get_comment_meta($message->get_id(), 'attachment_id', true);
    if ($attachment_id):
        $attachment_url = wp_get_attachment_url($attachment_id);
        $attachment_name = basename(get_attached_file($attachment_id));
        if ($attachment_url):
    ?>
        <div class="hp-message__attachment">
            <strong><?php echo esc_html__('Attachment', 'hivepress-messages'); ?>:</strong>
            <a href="<?php echo esc_url($attachment_url); ?>" target="_blank">
                <?php echo esc_html($attachment_name); ?>
            </a>
        </div>
    <?php
        endif;
    endif;
    ?>
</div>

Here is the main error log output:

[19-Feb-2025 08:59:11 UTC] No attachment found in $_FILES
[19-Feb-2025 08:59:11 UTC] No attachment found or attachment name is empty

So my wish is for you to:

1. Explain and give guidance on where the problem lies (and hopefully provide me the right code) so that I have my file attachments also send through. Thank you.

2. Show me how to rather implement the changes on for message-text.php or any other hivepress-messages template changes instead on the child experthive theme.
   

   
   
   
   

[ihor]

Hi,

Please override the message-text.php file with a child theme first, otherwise any direct changes in it will be erased on update. This is the only way to override template parts of any extension or the main theme without losing customizations. You can copy it to child-theme-folder/hivepress/message/view/message-text.php location. Please check if it’s overridded by adding any random text to it, it should appear in each message.

The next step, if you already added code for the hivepress/v1/models/message and hivepress/v1/forms/message_send forms to have new custom fields and these fields are saved for each message, you can output them in message-text.php file copied to the child theme. You can do this via echo $message->display_fieldnamehere(); Please remember to escape output for security.

If you want to add the attachment field this way it’s pretty tricky, because files are not passed to the REST API request made by the form. Please consider using the built-in attachment feature, you can enable it in HivePress/Settings/Messages. Then each message can have an attachment and it will be displayed for download automatically.

Hope this helps