ReadMe update, added support for showOnCondition: (() -> Boolean)?

Author: ItzNotABug

Readme.md

@@ -59,10 +59,18 @@ parentLayout.addView(adContainerView)
 // And thats it!
 ```
 **All Methods:**
-*   `insertAdView(@NonNull adUnitId, adSize, adRequest)`:\
-    The arguments `adSize` & `adRequest` are optional\
-    The default value of parameter `adSize` is `ADAPTIVE`.\
-    Pass your `AdRequest` if you have a customized request.
+```kotlin
+fun insertAdView(
+  @NonNull adUnitId: String,
+  adSize: AdSize,
+  adRequest: AdRequest),
+  showOnCondition: (() -> Boolean)? = null
+)
+```
+The arguments `adSize` & `adRequest` are optional\
+The default value of parameter `adSize` is `ADAPTIVE`.\
+Pass your `AdRequest` if you have a customized request.\
+Pass you condition to evaluate whether to show the Ad or not (Default is Null).
 
 *   `isLoading(): Boolean`: Returns `true` if the Ad is currently loading, `false` otherwise.
 

acv/build.gradle

@@ -16,8 +16,8 @@ android {
     defaultConfig {
         minSdkVersion 16
         targetSdkVersion 31
-        versionCode 21
-        versionName "0.2.1"
+        versionCode 22
+        versionName "0.2.2"
     }
 
     buildTypes {

acv/src/main/java/com/lazygeniouz/acv/AdContainerView.kt

@@ -52,13 +52,24 @@ class AdContainerView @JvmOverloads constructor(
     fun insertAdView(
         @NonNull adUnitId: String = this.adUnitId,
         adSize: AdSize = this.adSize,
-        adRequest: AdRequest = this.getAdRequest()
+        adRequest: AdRequest = this.getAdRequest(),
+        showOnCondition: (() -> Boolean)? = null
     ) {
         if (adUnitId == TEST_AD_ID) Log.i(
-            tag,
-            "Current adUnitId is a Test Ad Unit, make sure to use your own in Production"
+            tag, "Current adUnitId is a Test Ad Unit, make sure to use your own in Production"
         )
 
+        if (showOnCondition?.invoke() == false) {
+            Log.d(tag, showOnConditionMessage)
+            listener?.onAdFailedToLoad(
+                LoadAdError(
+                    -1, showOnConditionMessage,
+                    tag, null, null
+                )
+            )
+            return
+        }
+
         removeAllViews()
         newAdView = AdView(context)
         newAdView!!.visibility = View.GONE

acv/src/main/java/com/lazygeniouz/acv/base/BaseAd.kt

@@ -30,6 +30,8 @@ open class BaseAd @JvmOverloads constructor(
 ) : RelativeLayout(context, attrs, defStyleAttr) {
 
     internal val tag = javaClass.simpleName
+    internal val showOnConditionMessage =
+        "showOnCondition lambda returned false, AdContainerView will not load an Ad."
 
     protected var autoLoad = false
     internal var isAdLoaded = false
@@ -74,7 +76,7 @@ open class BaseAd @JvmOverloads constructor(
     /**
      * Return whether the Ad is loaded or not
      */
-    fun isAdLoaded(): Boolean = isAdLoaded
+    fun isAdLoaded() = isAdLoaded
 
     /**
      * Return the Ad's Loading State.