docs: update docs about customization (#79)

Author: EduardoJM

docs/docs/customization/_category_.json

@@ -1,5 +1,4 @@
 {
-    "label": "Customization",
-    "position": 4
-  }
-  
+  "label": "Customization",
+  "position": 4
+}

docs/docs/customization/text-and-icons.md

@@ -0,0 +1,77 @@
+---
+sidebar_position: 2
+---
+
+# Text And Icons
+
+To customize the image uploader widget or inline you can set some variables (this feature is based on the issue [#77](https://github.com/inventare/django-image-uploader-widget/issues/77)). In this page we talk about how to, easy, change the texts and icons on that lib.
+
+
+## Widget
+
+For the widget, to customize the icon and the text we need to set some variables in the `ImageUploaderWidget` constructor, like it:
+
+```python
+# ...
+class TestCustomForm(forms.ModelForm):
+    class Meta:
+        model = CustomWidget
+        widgets = {
+            'image': ImageUploaderWidget(
+                drop_icon="<svg ...></svg>",
+                drop_text="Custom Drop Text",
+                empty_icon="<svg ...></svg>",
+                empty_text="Custom Empty Marker Text",
+            ),
+        }
+        fields = '__all__'
+```
+
+In this example, we set all four properties (`drop_icon`, `drop_text`, `empty_icon` and `empty_text`) for the widget. In the icons is possible to use the `django.shortcuts.render` ([REF](https://docs.djangoproject.com/en/4.1/topics/http/shortcuts/#render)) to renderize the icon from an HTML template.
+
+Another way for customize it is create an new widget class based on that and use it for your forms:
+
+```python
+class MyCustomWidget(ImageUploaderWidget):
+    drop_text = ""
+    empty_text = ""
+
+    def get_empty_icon(self):
+        return render(...)
+    
+    def get_drop_icon(self):
+        return render(...)
+
+class TestCustomForm(forms.ModelForm):
+    class Meta:
+        model = CustomWidget
+        widgets = {
+            'image': MyCustomWidget()
+        }
+        fields = '__all__'
+```
+
+## Inline Editor
+
+To customize the text and the icons of the inline editor is a little bit faster too. We can set some variables on the `InlineAdmin` of your model, like this:
+
+```python
+class CustomInlineEditor(ImageUploaderInline):
+    model = models.CustomInlineItem
+    add_image_text = "add_image_text"
+    drop_text = "drop_text"
+    empty_text = "empty_text"
+
+    def get_empty_icon(self):
+        return render(...)
+
+    def get_add_icon(self):
+        return render(...)
+
+    def get_drop_icon(self):
+        return render(...)
+
+@admin.register(models.CustomInline)
+class CustomInlineAdmin(admin.ModelAdmin):
+    inlines = [CustomInlineEditor]
+```

docs/docs/development/tests.md

@@ -10,6 +10,10 @@ To maintain the integrity of the features of this project we have written some i
 In the decision to write the tests we opted for writing only integration tests using the selenium. And the reason for it is: our project uses much more JavaScript for web browser than Python code for back-end and runs in high coupling with the django-admin. In this context, unit tests are expendable.
 :::
 
+:::note Some unit tests
+In the note block above i talked about not using unit test cases, and in the decisions of the issue [#77](https://github.com/inventare/django-image-uploader-widget/issues/77) we decided to add one unit test for the translation of the widget ([tests/widget_customized.py](https://github.com/inventare/django-image-uploader-widget/blob/main/image_uploader_widget_demo/tests/widget_customized.py#L5)).
+:::
+
 ## Some Tests Decisions and Workarounds
 
 When testing with selenium is not possible to hack the file picker to choose some file. And in this project, in some moments we use an *temporary file input* for choosing files without compromise the current choosed file. Based on those context, to test correctly fires to onClick event of the *temporary file input*, we added an JavaScript to add an onClick event showing an alert and test for this alert into the screen.

docs/docusaurus.config.js

@@ -50,11 +50,6 @@ const config = {
         },
         items: [
           { type: 'doc', docId: 'intro', position: 'left', label: 'Documentation', },
-          {
-            type: 'docsVersionDropdown',
-            position: 'right',
-            dropdownActiveClassDisabled: true,
-          },
           { href: 'https://github.com/inventare/django-image-uploader-widget', label: 'GitHub', position: 'right', },
         ],
       },