<?php

// *****************************************************************************
// AD-SWAPPER.APP / AVAILABLE-SITES-GET-NEW-FIELD-VALUE-FUNCTIONS.PHP
// (C) 2015 Peter Newman. All Rights Reserved.
// *****************************************************************************

    namespace greatKiwi_byFernTec_adSwapper_local_v0x1x208_datasetDef_adSwapperAvailableSites ;

// =============================================================================
// get_new_field_value_4_question_trial_mode_site()
// =============================================================================

function get_new_field_value_4_question_trial_mode_site(
    $core_plugapp_dirs                          ,
    $loaded_datasets                            ,
    $dataset_slug                               ,
    $selected_datasets_dmdd                     ,
    $record_indices_by_field_slug_to_add        ,
    $record_indices_by_field_slug_to_remove     ,
    $this_record                                ,
    $field_slug_to_add                          ,
    $get_new_field_value_function_args
    ) {

    // -------------------------------------------------------------------------
    // <get_new_field_value_function>(
    //      $core_plugapp_dirs                          ,
    //      $loaded_datasets                            ,
    //      $dataset_slug                               ,
    //      $selected_datasets_dmdd                     ,
    //      $record_indices_by_field_slug_to_add        ,
    //      $record_indices_by_field_slug_to_remove     ,
    //      $this_record                                ,
    //      $field_slug_to_add                          ,
    //      $get_new_field_value_function_args
    //      )
    // - - - - - - - - - - - - - - - - - - - - - - - - -
    // Returns the value for the specified field to be added to the
    // specified record.
    //
    // RETURNS
    //      On SUCCESS
    //          array(
    //              $ok = TRUE
    //              $new_field_value (any PHP type)
    //              )
    //
    //      On FAILURE
    //          array(
    //              $ok = FALSE
    //              $error_message STRING
    //              )
    // -------------------------------------------------------------------------

    $new_field_value = FALSE ;

    // -------------------------------------------------------------------------

    return array(
        TRUE                ,
        $new_field_value
        ) ;

    // -------------------------------------------------------------------------

}

// =============================================================================
// get_new_field_value_4_this_site_approves_plugin_site()
// =============================================================================

function get_new_field_value_4_this_site_approves_plugin_site(
    $core_plugapp_dirs                          ,
    $loaded_datasets                            ,
    $dataset_slug                               ,
    $selected_datasets_dmdd                     ,
    $record_indices_by_field_slug_to_add        ,
    $record_indices_by_field_slug_to_remove     ,
    $this_record                                ,
    $field_slug_to_add                          ,
    $get_new_field_value_function_args
    ) {

    // -------------------------------------------------------------------------
    // <get_new_field_value_function>(
    //      $core_plugapp_dirs                          ,
    //      $loaded_datasets                            ,
    //      $dataset_slug                               ,
    //      $selected_datasets_dmdd                     ,
    //      $record_indices_by_field_slug_to_add        ,
    //      $record_indices_by_field_slug_to_remove     ,
    //      $this_record                                ,
    //      $field_slug_to_add                          ,
    //      $get_new_field_value_function_args
    //      )
    // - - - - - - - - - - - - - - - - - - - - - - - - -
    // Returns the value for the specified field to be added to the
    // specified record.
    //
    // RETURNS
    //      On SUCCESS
    //          array(
    //              $ok = TRUE
    //              $new_field_value (any PHP type)
    //              )
    //
    //      On FAILURE
    //          array(
    //              $ok = FALSE
    //              $error_message STRING
    //              )
    // -------------------------------------------------------------------------

    $new_field_value = FALSE ;

    // -------------------------------------------------------------------------

    return array(
        TRUE                ,
        $new_field_value
        ) ;

    // -------------------------------------------------------------------------

}

// =============================================================================
// get_new_field_value_4_this_site_targets_plugin_site()
// =============================================================================

function get_new_field_value_4_this_site_targets_plugin_site(
    $core_plugapp_dirs                          ,
    $loaded_datasets                            ,
    $dataset_slug                               ,
    $selected_datasets_dmdd                     ,
    $record_indices_by_field_slug_to_add        ,
    $record_indices_by_field_slug_to_remove     ,
    $this_record                                ,
    $field_slug_to_add                          ,
    $get_new_field_value_function_args
    ) {

    // -------------------------------------------------------------------------
    // <get_new_field_value_function>(
    //      $core_plugapp_dirs                          ,
    //      $loaded_datasets                            ,
    //      $dataset_slug                               ,
    //      $selected_datasets_dmdd                     ,
    //      $record_indices_by_field_slug_to_add        ,
    //      $record_indices_by_field_slug_to_remove     ,
    //      $this_record                                ,
    //      $field_slug_to_add                          ,
    //      $get_new_field_value_function_args
    //      )
    // - - - - - - - - - - - - - - - - - - - - - - - - -
    // Returns the value for the specified field to be added to the
    // specified record.
    //
    // RETURNS
    //      On SUCCESS
    //          array(
    //              $ok = TRUE
    //              $new_field_value (any PHP type)
    //              )
    //
    //      On FAILURE
    //          array(
    //              $ok = FALSE
    //              $error_message STRING
    //              )
    // -------------------------------------------------------------------------

    $new_field_value = FALSE ;

    // -------------------------------------------------------------------------

    return array(
        TRUE                ,
        $new_field_value
        ) ;

    // -------------------------------------------------------------------------

}

// =============================================================================
// That's that!
// =============================================================================