enhance: Implement vendor default banner, profile image & controls.

assets/src/less/store.less

@@ -231,7 +231,6 @@
                 height: auto;
 
                 &.dummy-image {
-                    background-image: url(../../images/default-store-banner.png);
                     background-size: 100% 100%;
                     background-repeat: no-repeat;
 

includes/Admin/Settings.php

@@ -90,7 +90,7 @@
      * @return void
      */
     public function get_settings_value() {
         if ( ! current_user_can( 'manage_woocommerce' ) ) {
             wp_send_json_error( __( 'You have no permission to get settings value', 'dokan-lite' ) );
         }
 
@@ -116,7 +116,7 @@
      */
     public function save_settings_value() {
         try {
             if ( ! current_user_can( 'manage_woocommerce' ) ) {
                 throw new DokanException( 'dokan_settings_unauthorized_operation', __( 'You are not authorized to perform this action.', 'dokan-lite' ), 401 );
             }
 
@@ -594,6 +594,10 @@
             ]
         );
 
+        // Collect store banner dimensions for croppable fields.
+        $store_banner_width  = dokan()->is_pro_exists() ? dokan_get_option( 'store_banner_width', 'dokan_appearance', 625 ) : 625;
+        $store_banner_height = dokan()->is_pro_exists() ? dokan_get_option( 'store_banner_height', 'dokan_appearance', 300 ) : 300;
+
         $settings_fields = [
             'dokan_general'    => array_merge(
                 $general_site_options,
@@ -808,6 +812,26 @@
                     ],
                     'default' => 'default',
                 ],
+                'default_store_banner'       => [
+                    'name'            => 'default_store_banner',
+                    'label'           => __( 'Default Store Banner', 'dokan-lite' ),
+                    'type'            => 'croppable_image',
+                    'default'         => DOKAN_PLUGIN_ASSEST . '/images/default-store-banner.png',
+                    'restore'         => true,
+                    'render_width'    => 625,
+                    'cropping_width'  => $store_banner_width,
+                    'cropping_height' => $store_banner_height,
+                ],
+                'default_store_profile'      => [
+                    'name'            => 'default_store_profile',
+                    'label'           => __( 'Default Store Profile Picture', 'dokan-lite' ),
+                    'type'            => 'croppable_image',
+                    'default'         => DOKAN_PLUGIN_ASSEST . '/images/mystery-person.jpg',
+                    'restore'         => true,
+                    'render_width'    => 120,
+                    'cropping_width'  => 625,
+                    'cropping_height' => 625,
+                ],
                 'store_open_close'           => [
                     'name'    => 'store_open_close',
                     'label'   => __( 'Store Opening Closing Time Widget', 'dokan-lite' ),

includes/Dashboard/Templates/Settings.php

@@ -131,7 +131,7 @@
         }
 
         // check if user have permission to view settings page
         if ( ! current_user_can( 'dokan_view_store_settings_menu' ) ) {
             dokan_get_template_part(
                 'global/dokan-error', '', [
                     'deleted' => false,
@@ -161,12 +161,12 @@
      * @return void
      */
     public function load_store_content() {
-        $currentuser  = dokan_get_current_user_id();
-        $profile_info = dokan_get_store_info( dokan_get_current_user_id() );
+        $current_user = dokan_get_current_user_id();
+        $profile_info = dokan_get_store_info( $current_user );
 
         dokan_get_template_part(
             'settings/store-form', '', [
-                'current_user' => $currentuser,
+                'current_user' => $current_user,
                 'profile_info' => $profile_info,
             ]
         );
@@ -317,7 +317,7 @@
 
         switch ( sanitize_text_field( wp_unslash( $_POST['form_id'] ) ) ) { // phpcs:ignore
             case 'profile-form':
                 if ( ! current_user_can( 'dokan_view_store_social_menu' ) ) {
                     wp_send_json_error( __( 'Pemission denied social', 'dokan-lite' ) );
                 }
 
@@ -329,7 +329,7 @@
                 break;
 
             case 'store-form':
                 if ( ! current_user_can( 'dokan_view_store_settings_menu' ) ) {
                     wp_send_json_error( __( 'Pemission denied', 'dokan-lite' ) );
                 }
 
@@ -341,7 +341,7 @@
                 break;
 
             case 'payment-form':
                 if ( ! current_user_can( 'dokan_view_store_payment_menu' ) ) {
                     wp_send_json_error( __( 'Pemission denied', 'dokan-lite' ) );
                 }
 
@@ -563,8 +563,8 @@
 
             // Get & set 7 days opening & closing time for update dokan store time.
             foreach ( $dokan_days as $day_key => $day ) {
                 $opening_time = isset( $_POST['opening_time'][ $day_key ] ) ? wc_clean( wp_unslash( $_POST['opening_time'][ $day_key ] ) ) : '';
                 $closing_time = isset( $_POST['closing_time'][ $day_key ] ) ? wc_clean( wp_unslash( $_POST['closing_time'][ $day_key ] ) ) : '';
                 $store_status = ! empty( $_POST[ $day_key ]['working_status'] ) ? sanitize_text_field( wp_unslash( $_POST[ $day_key ]['working_status'] ) ) : 'close';
 
                 // If open or closing time is array then return from here.
@@ -609,11 +609,11 @@
             // Update store settings info.
             $dokan_settings = [
                 'store_name'               => isset( $_POST['dokan_store_name'] ) ? sanitize_text_field( wp_unslash( $_POST['dokan_store_name'] ) ) : '',
                 'address'                  => isset( $_POST['dokan_address'] ) ? wc_clean( wp_unslash( $_POST['dokan_address'] ) ) : $prev_dokan_settings['address'],
                 'location'                 => $location,
                 'find_address'             => $find_address,
                 'banner'                   => isset( $_POST['dokan_banner'] ) ? absint( $_POST['dokan_banner'] ) : 0,
                 'phone'                    => isset( $_POST['setting_phone'] ) ? dokan_sanitize_phone_number( wp_unslash( $_POST['setting_phone'] ) ) : 'no',
                 'show_email'               => isset( $_POST['setting_show_email'] ) ? sanitize_text_field( wp_unslash( $_POST['setting_show_email'] ) ) : 'no',
                 'gravatar'                 => isset( $_POST['dokan_gravatar'] ) ? absint( $_POST['dokan_gravatar'] ) : 0,
                 'enable_tnc'               => isset( $_POST['dokan_store_tnc_enable'] ) && 'on' === sanitize_text_field( wp_unslash( $_POST['dokan_store_tnc_enable'] ) ) ? 'on' : 'off',
@@ -633,7 +633,7 @@
             ];
 
             if ( isset( $_POST['settings']['bank'] ) ) {
                 $bank = wc_clean( wp_unslash( $_POST['settings']['bank'] ) );
 
                 $dokan_settings['payment']['bank'] = [
                     'ac_name'        => $bank['ac_name'],
@@ -821,7 +821,7 @@
      *
      * @return string
      */
     public function get_method_frontend_title( $title, $method ) {
         if ( 0 === stripos( $title, 'Dokan ' ) ) {
             return substr( $title, 6 );
         }

includes/Vendor/Vendor.php

@@ -436,14 +436,59 @@ public function get_location() {
     }
 
     /**
-     * Get the shop banner
+     * Get the store banner URL.
+     *
+     * This method first checks if a specific banner ID is set for the store and retrieves it. If not set,
+     * it falls back to the default store banner defined in the Dokan settings.
+     *
+     * @since DOKAN_SINCE Applied default banner image.
      *
      * @return string
      */
-    public function get_banner() {
-        $banner_id = $this->get_banner_id();
+    public function get_banner(): string {
+        // Check if a specific banner ID is set and return its URL.
+        if ( $this->get_banner_id() ) {
+            return wp_get_attachment_url( $this->get_banner_id() );
+        }
+
+        // Define the default store banner URL from plugin assets.
+        $default_store_banner = $this->get_default_banner();
+
+        // Retrieve the default banner URL from Dokan settings, with fallback to the plugin's default banner.
+        $banner_url = dokan_get_option( 'default_store_banner', 'dokan_appearance', $default_store_banner );
+
+        /**
+         * Filters for the store banner URL.
+         *
+         * Allows overriding of the store banner URL via external plugins or themes.
+         * This is particularly useful if there is a need to dynamically change the banner based on specific conditions or configurations.
+         *
+         * @since DOKAN_SINCE
+         *
+         * @param string $banner_url The URL of the default banner.
+         * @param Vendor $this       Instance of the current class.
+         */
+        return apply_filters( 'dokan_get_banner_url', $banner_url, $this );
+    }
+
+    /**
+     * Get the default store banner URL.
+     *
+     * @since DOKAN_SINCE
+     *
+     * @return void
+     */
+    public function get_default_banner(): string {
 
-        return $banner_id ? wp_get_attachment_url( $banner_id ) : '';
+        /**
+         * Filters for the default store banner URL.
+         *
+         * Allows overriding of the default store banner URL via external plugins or themes.
+         * This is particularly useful if there is a need to dynamically change the banner based on specific conditions or configurations.
+         *
+         * @since DOKAN_SINCE
+         */
+        return apply_filters( 'dokan_get_banner_url', DOKAN_PLUGIN_ASSEST . '/images/default-store-banner.png' );
     }
 
     /**
@@ -460,20 +505,59 @@ public function get_banner_id() {
     }
 
     /**
-     * Get the shop profile icon
+     * Get the shop profile icon.
      *
      * @since 2.8
+     * @since DOKAN_SINCE Applied default vendor profile image.
      *
      * @return string
      */
-    public function get_avatar() {
+    public function get_avatar(): string {
         $avatar_id = $this->get_avatar_id();
 
-        if ( ! $avatar_id && ! empty( $this->data->user_email ) ) {
-            return get_avatar_url( $this->data->user_email, 96 );
+        // Check if a specific avatar ID is set and return its URL.
+        if ( $avatar_id ) {
+            return wp_get_attachment_url( $avatar_id );
         }
 
-        return wp_get_attachment_url( $avatar_id );
+        // Define the default avatar URL from plugin assets.
+        $default_store_avatar = $this->get_default_avatar();
+
+        // Retrieve the default avatar URL from Dokan settings, with fallback to the plugin's default avatar.
+        $avatar_url = dokan_get_option( 'default_store_profile', 'dokan_appearance', $default_store_avatar );
+
+        /**
+         * Filters for the store avatar URL.
+         *
+         * Allows overriding of the store avatar URL via external plugins or themes.
+         * This is particularly useful if there is a need to dynamically change the avatar based on specific conditions or configurations.
+         *
+         * @since DOKAN_SINCE
+         *
+         * @param string $avatar_url The URL of the default avatar.
+         * @param Vendor $this       Instance of the current class.
+         */
+        return apply_filters( 'dokan_get_avatar_url', $avatar_url, $this );
+    }
+
+    /**
+     * Get the default store avatar URL.
+     *
+     * @since DOKAN_SINCE
+     *
+     * @return string
+     */
+    public function get_default_avatar(): string {
+
+        /**
+         * Filters for the default store avatar URL.
+         *
+         * Allows overriding of the default store avatar URL via external plugins or themes.
+         * This is particularly useful if there is a need to dynamically change the avatar based on specific conditions or configurations.
+         *
+         * @since DOKAN_SINCE
+         */
+        return apply_filters( 'dokan_get_default_avatar_url', DOKAN_PLUGIN_ASSEST . '/images/mystery-person.jpg' );
     }
 
     /**

src/admin/components/FieldHeading.vue

@@ -12,7 +12,10 @@
                 ></i>
             </span>
         </h3>
-        <p class="field_desc" v-html="fieldData.desc"></p>
+        <p class="field_desc" v-if="fieldData.desc" v-html="fieldData.desc"></p>
+        <p class="field_default" v-if="fieldData.type === 'croppable_image' && fieldData.restore === true">
+            <a href="" v-on:click.prevent="restoreDefaultImage()">{{ __( 'Restore Default', 'dokan-lite' ) }}</a>
+        </p>
     </div>
 </template>
 
@@ -21,5 +24,23 @@
         name : 'FieldHeading',
 
         props : ['fieldData'],
+
+        methods: {
+            restoreDefaultImage() {
+                Swal.fire({
+                    icon              : 'warning',
+                    html              : this.__( 'Would you like to revert back to the default state?', 'dokan-lite' ),
+                    title             : this.__( 'Are you sure?', 'dokan-lite' ),
+                    showCancelButton  : true,
+                    cancelButtonText  : this.__( 'No, Cancel', 'dokan-lite' ),
+                    confirmButtonText : this.__( 'Yes, Reset', 'dokan-lite' ),
+                }).then( ( response ) => {
+                    if ( response.isConfirmed ) {
+                        this.$root.$emit( 'dokanRestoreDefault', this.fieldData );
+                        Swal.fire( this.__( 'Success', 'dokan-lite' ), '', 'success' );
+                    }
+                });
+            }
+        }
     };
 </script>

src/admin/components/Fields.vue

@@ -272,6 +272,27 @@
             </div>
         </template>
 
+        <template v-if="'croppable_image' === fieldData.type">
+            <div class="field_contents" v-bind:class="[fieldData.content_class ? fieldData.content_class : '']">
+                <fieldset>
+                    <FieldHeading :fieldData="fieldData"></FieldHeading>
+                    <div class="field add_files">
+                        <label :style="{ maxWidth: fieldData.render_width + 'px' }" :for="sectionId + '[' + fieldData.name + ']'">
+                            <UploadImage
+                                :croppingWidth="parseInt( croppingWidth )"
+                                :croppingHeight="parseInt( croppingHeight )"
+                                :src="fieldValue[fieldData.name]"
+                                @uploadedImage="uploadedImage"
+                                :showButton="false" />
+                        </label>
+                    </div>
+                </fieldset>
+                <p v-if="hasError( fieldData.name )" class="dokan-error">
+                    {{ getError( fieldData.label ) }}
+                </p>
+            </div>
+        </template>
+
         <template v-if="'color' === fieldData.type">
             <div class="field_contents" v-bind:class="[fieldData.content_class ? fieldData.content_class : '']">
                 <fieldset>
@@ -511,6 +532,7 @@
     import SecretInput from './SecretInput.vue';
     import WithdrawCharges from './Fields/WithdrawCharges.vue'
     import DokanRadioGroup from "admin/components/DokanRadioGroup.vue";
+    import UploadImage from "admin/components/UploadImage.vue";
 
     let Mapbox                = dokan_get_lib('Mapbox');
     let TextEditor            = dokan_get_lib('TextEditor');
@@ -521,7 +543,8 @@
         name: 'Fields',
 
         components: {
-          DokanRadioGroup,
+            UploadImage,
+            DokanRadioGroup,
             Mapbox,
             Switches,
             TextEditor,
@@ -542,12 +565,15 @@
                 checked               : this.isChecked(),
                 socialChecked         : this.isSocialChecked(),
                 expandSocials         : false,
+                croppingWidth         : this.fieldData.cropping_width,
+                croppingHeight        : this.fieldData.cropping_height,
                 repeatableItem        : {},
                 repeatableTime        : [],
                 singleColorPicker     : { default: this.fieldData.default, label: '', show_pallete: false },
                 yourStringTimeValue   : '',
                 customFieldComponents : dokan.hooks.applyFilters( 'getDokanCustomFieldComponents', [] ),
                 multiCheckValues      : {},
+                dokanProExists        : dokan.hasPro,
             }
         },
 
@@ -565,11 +591,21 @@
                     this.checked = value;
                 }
             });
+
+            this.$root.$on( 'dokanRestoreDefault', ( fieldData ) => {
+                if ( this.fieldValue[ fieldData.name ] !== fieldData.default ) {
+                    this.fieldValue[ fieldData.name ] = fieldData.default
+                }
+            });
         },
 
         watch: {
             fieldValue: {
-                handler() {
+                handler( newValue ) {
+                    if ( this.id === 'default_store_banner' ) {
+                        this.croppingWidth = newValue.store_banner_width;
+                        this.croppingHeight = newValue.store_banner_height;
+                    }
                 },
                 deep: true,
             }
@@ -723,6 +759,11 @@
                   fieldData.is_lite ?? false
                 );
             },
+
+            uploadedImage( image ) {
+                this.fieldValue[ this.id ] = this.validateInputData( this.id, image.src, this.fieldValue[ this.id ], this.fieldData );
+            },
+
             inputValueHandler( name, newValue, oldValue ) {
               this.fieldValue[ name ] = this.validateInputData( name, newValue, oldValue, this.fieldData );
             },
@@ -1095,6 +1136,10 @@
                         }
                     }
                 }
+
+                .field_default {
+                    margin: 0;
+                }
             }
 
             .social-switch-wraper {

src/admin/components/UploadImage.vue

@@ -274,6 +274,7 @@ export default {
         width: 100%;
 
         img {
+            width: 100%;
             cursor: pointer;
         }
     }

templates/settings/store-form.php

@@ -4,8 +4,7 @@
  *
  * @since 2.4
  */
-?>
-<?php
+
 $gravatar_id    = ! empty( $profile_info['gravatar'] ) ? $profile_info['gravatar'] : 0;
 $banner_id      = ! empty( $profile_info['banner'] ) ? $profile_info['banner'] : 0;
 $storename      = isset( $profile_info['store_name'] ) ? $profile_info['store_name'] : '';
@@ -59,15 +58,15 @@
 
     <div class="dokan-banner">
 
-        <div class="image-wrap<?php echo $banner_id ? '' : ' dokan-hide'; ?>">
-            <?php $banner_url = $banner_id ? wp_get_attachment_url( $banner_id ) : ''; ?>
+        <?php $banner_url = $banner_id ? wp_get_attachment_url( $banner_id ) : ''; ?>
+        <div class="image-wrap<?php echo esc_url( $banner_url ) ? '' : ' dokan-hide'; ?>">
             <input type="hidden" class="dokan-file-field" value="<?php echo esc_attr( $banner_id ); ?>" name="dokan_banner">
             <img class="dokan-banner-img" src="<?php echo esc_url( $banner_url ); ?>">
 
             <a class="close dokan-remove-banner-image">&times;</a>
         </div>
 
-        <div class="button-area<?php echo $banner_id ? ' dokan-hide' : ''; ?>">
+        <div class="button-area<?php echo esc_url( $banner_url ) ? ' dokan-hide' : ''; ?>">
             <i class="fas fa-cloud-upload-alt"></i>
             <a href="#" class="dokan-banner-drag dokan-btn dokan-btn-info dokan-theme dokan-btn-theme"><?php esc_html_e( 'Upload banner', 'dokan-lite' ); ?></a>
             <p class="help-block">
@@ -99,13 +98,13 @@
         <label class="dokan-w3 dokan-control-label" for="dokan_gravatar"><?php esc_html_e( 'Profile Picture', 'dokan-lite' ); ?></label>
 
         <div class="dokan-w5 dokan-gravatar">
-            <div class="dokan-left gravatar-wrap<?php echo $gravatar_id ? '' : ' dokan-hide'; ?>">
-                <?php $gravatar_url = $gravatar_id ? wp_get_attachment_url( $gravatar_id ) : ''; ?>
+            <?php $gravatar_url = $gravatar_id ? wp_get_attachment_url( $gravatar_id ) : ''; ?>
+            <div class="dokan-left gravatar-wrap<?php echo esc_url( $gravatar_url ) ? '' : ' dokan-hide'; ?>">
                 <input type="hidden" class="dokan-file-field" value="<?php echo esc_attr( $gravatar_id ); ?>" name="dokan_gravatar">
                 <img class="dokan-gravatar-img" src="<?php echo esc_url( $gravatar_url ); ?>">
                 <a class="dokan-close dokan-remove-gravatar-image">&times;</a>
             </div>
-            <div class="gravatar-button-area<?php echo esc_attr( $gravatar_id ) ? ' dokan-hide' : ''; ?>">
+            <div class="gravatar-button-area<?php echo esc_url( $gravatar_url ) ? ' dokan-hide' : ''; ?>">
                 <a href="#" class="dokan-pro-gravatar-drag dokan-btn dokan-btn-default"><i class="fas fa-cloud-upload-alt"></i> <?php esc_html_e( 'Upload Photo', 'dokan-lite' ); ?></a>
             </div>
         </div>