<?php

// *****************************************************************************
// AD-SWAPPER.APP / SITE-PROFILE-GET-NEW-FIELD-VALUE-FUNCTIONS.PHP
// (C) 2015 Peter Newman. All Rights Reserved.
// *****************************************************************************

    namespace greatKiwi_byFernTec_adSwapper_local_v0x1x210_datasetDef_adSwapperSiteProfile ;

// =============================================================================
// get_new_field_value_4_show_ads_list_reload_buttons()
// =============================================================================

function get_new_field_value_4_show_ads_list_reload_buttons(
    $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
    //              )
    // -------------------------------------------------------------------------

    $success = TRUE  ;
    $failure = FALSE ;

    // -------------------------------------------------------------------------

    if (    array_key_exists(
                'hide_ads_list_reload_buttons'  ,
                $this_record
                )
            &&
            is_bool( $this_record['hide_ads_list_reload_buttons'] )
        ) {

        if ( $this_record['hide_ads_list_reload_buttons'] === TRUE ) {
            $new_field_value = FALSE ;

        } else {
            $new_field_value = TRUE ;

        }

    } else {

        $new_field_value = FALSE ;

    }

    // -------------------------------------------------------------------------

    return array(
        TRUE                ,
        $new_field_value
        ) ;

    // -------------------------------------------------------------------------

}

// =============================================================================
// get_new_field_value_4_question_manual_update_approval()
// =============================================================================

function get_new_field_value_4_question_manual_update_approval(
    $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_question_auto_approve_new_ads()
// =============================================================================

function get_new_field_value_4_question_auto_approve_new_ads(
    $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_question_disable_incoming_ads()
// =============================================================================

function get_new_field_value_4_question_disable_incoming_ads(
    $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_question_disable_outgoing_ads()
// =============================================================================

function get_new_field_value_4_question_disable_outgoing_ads(
    $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_license_key()
// =============================================================================

function get_new_field_value_4_license_key(
    $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 = '' ;

    // -------------------------------------------------------------------------

    return array(
        TRUE                ,
        $new_field_value
        ) ;

    // -------------------------------------------------------------------------

}

// =============================================================================
// new_field_value_is_empty_string()
// =============================================================================

function new_field_value_is_empty_string(
    $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
    ) {

    // -------------------------------------------------------------------------
    // <array_stored_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 = '' ;

    // -------------------------------------------------------------------------

    return array(
        TRUE                ,
        $new_field_value
        ) ;

    // -------------------------------------------------------------------------

}

// =============================================================================
// That's that!
// =============================================================================