Add wagtail@8 fallback imports re/ warnings

Author: jacobcolyvan

README.md

@@ -205,6 +205,10 @@ Much of this library was built atop of the work of others, specifically:
 
 When upgrading this, ensure both `InstanceSelectorPanel` and `InstanceSelectorBlock` are tested manually via the example projects as they use different JavaScript integration approaches.
 
+The example project is setup for testing via:
+- `Shop` model admin for `InstanceSelectorBlock` testing.
+- `Product` model admin `InstanceSelectorPanel` testing.
+
 ### Run tests
 
 ```

example/example_project/settings.py

@@ -116,6 +116,8 @@
 
 USE_TZ = True
 
+DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
+
 
 # Static files (CSS, JavaScript, Images)
 # https://docs.djangoproject.com/en/2.2/howto/static-files/

instance_selector/blocks.py

@@ -2,7 +2,13 @@
 from wagtail.blocks import ChooserBlock
 from wagtail.blocks.field_block import FieldBlockAdapter
 from wagtail.coreutils import resolve_model_string
-from wagtail.telepath import register
+
+# Handle Wagtail 8.0+ import location changes
+try:
+    from wagtail.admin.telepath import register
+except ImportError:
+    # Fallback for Wagtail < 8.0
+    from wagtail.telepath import register
 
 from instance_selector.registry import registry
 from instance_selector.widgets import InstanceSelectorWidget

instance_selector/widgets.py

@@ -5,8 +5,15 @@
 from django.urls import reverse
 from django.utils.safestring import mark_safe
 from django.utils.translation import gettext_lazy as _
-from wagtail.telepath import register
-from wagtail.widget_adapters import WidgetAdapter
+
+# Handle Wagtail 8.0+ import location changes
+try:
+    from wagtail.admin.telepath import register
+    from wagtail.admin.telepath.widgets import WidgetAdapter
+except ImportError:
+    # Fallback for Wagtail < 8.0
+    from wagtail.telepath import register
+    from wagtail.widget_adapters import WidgetAdapter
 
 from instance_selector.constants import OBJECT_PK_PARAM
 from instance_selector.registry import registry