[facebook] implement 'include' option & add 'avatar' extractor (#7848)

rename 'profile' extractor to 'photos'

docs/configuration.rst

@@ -2600,6 +2600,27 @@ description
     Extract comments that include photo attachments made by the author of the post.
 
 
+extractor.facebook.include
+--------------------------
+Type
+    * ``string``
+    * ``list`` of ``strings``
+Default
+    ``"photos"``
+Example
+    * ``"avatar,photos"``
+    * ``["avatar", "photos"]``
+Description
+    A (comma-separated) list of subcategories to include
+    when processing a user profile.
+
+    Supported values are
+    * ``"avatar"``
+    * ``"photos"``
+
+    It is possible to use ``"all"`` instead of listing all values separately.
+
+
 extractor.facebook.videos
 -------------------------
 Type

docs/gallery-dl.conf

@@ -293,6 +293,14 @@
             "limits-action"   : "stop",
             "fallback-retries": 2
         },
+        "facebook":
+        {
+            "cookies": null,
+
+            "author-followups": false,
+            "include": "photos",
+            "videos" : true
+        },
         "fanbox":
         {
             "cookies" : null,

docs/supportedsites.md

@@ -274,7 +274,7 @@ Consider all listed sites to potentially be NSFW.
 <tr>
     <td>Facebook</td>
     <td>https://www.facebook.com/</td>
-    <td>Photos, Profiles, Sets, Videos</td>
+    <td>Avatars, Photos, Profile Photos, Sets, User Profiles, Videos</td>
     <td><a href="https://github.com/mikf/gallery-dl#cookies">Cookies</a></td>
 </tr>
 <tr>