Writerside_libraries Help

Resources

This will document all the elements of the Resources screen.

1. Screen header

The information required for the screen text and the header image can be retrieved so:

Get page information

Getting the page title and the page's featured image requires two steps (2 requests)

  1. Request the page information

    curl -X GET 'https://maforum.ippf.org/wp-json/wp/v2/pages/18240' \ --header 'x-connect-allow: string' \ --header 'Authorization: Bearer token'
    { "id": 18240, "date": "2025-06-11T11:11:14", "date_gmt": "2025-06-11T10:11:14", "guid": { "rendered": "https://maforum.ippf.org/?page_id=18240" }, "modified": "2025-06-11T11:11:15", "modified_gmt": "2025-06-11T10:11:15", "slug": "map-resources", "status": "publish", "type": "page", "link": "https://maforum.ippf.org/map-resources/", "title": { "rendered": "Resources" }, "content": { "rendered": "", "protected": false }, "excerpt": { "rendered": "", "protected": false }, "author": 1, "featured_media": 18241, "parent": 0, "menu_order": 0, "comment_status": "closed", "ping_status": "closed", "template": "page-map-resources-tpl.php", "meta": { "_acf_changed": false, "inline_featured_image": false, "footnotes": "" }, "class_list": [ "post-18240", "page", "type-page", "status-publish", "has-post-thumbnail", "hentry" ], "acf": [], "map_nav": null, "lang": "en", "translations": { "en": 18240 }, "pll_sync_post": [], "_links": { "self": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/pages/18240", "targetHints": { "allow": [ "GET", "POST", "PUT", "PATCH", "DELETE" ] } } ], "collection": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/pages" } ], "about": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/types/page" } ], "author": [ { "embeddable": true, "href": "https://maforum.ippf.org/wp-json/wp/v2/users/1" } ], "replies": [ { "embeddable": true, "href": "https://maforum.ippf.org/wp-json/wp/v2/comments?post=18240" } ], "version-history": [ { "count": 1, "href": "https://maforum.ippf.org/wp-json/wp/v2/pages/18240/revisions" } ], "predecessor-version": [ { "id": 18242, "href": "https://maforum.ippf.org/wp-json/wp/v2/pages/18240/revisions/18242" } ], "wp:featuredmedia": [ { "embeddable": true, "href": "https://maforum.ippf.org/wp-json/wp/v2/media/18241" } ], "wp:attachment": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/media?parent=18240" } ], "curies": [ { "name": "wp", "href": "https://api.w.org/{rel}", "templated": true } ] } }
    Title

    Ex. "Resources ..." - title->rendered

    Header image

    Get the column featured_media and make the media request below.

  2. Request the media info based on information from the page request's response

    To get the featured image, you use the column featured_media which contains the ID of the media item.

    curl -X GET 'https://maforum.ippf.org/wp-json/wp/v2/media/55' \ --header 'x-connect-allow: string' \ --header 'Authorization: Bearer token'
    { "id": 36, "date": "2024-06-03T06:27:27", "date_gmt": "2024-06-03T06:27:27", "guid": { "rendered": "http://ma-forum.staging/wp-content/uploads/2024/06/home-image-opt.jpg" }, "modified": "2024-06-03T06:27:27", "modified_gmt": "2024-06-03T06:27:27", "slug": "home-image-opt", "status": "inherit", "type": "attachment", "link": "https://maforum.ippf.org/ma-forum/home-image-opt/", "title": { "rendered": "home-image-opt" }, "author": 1, "featured_media": 0, "comment_status": "", "ping_status": "closed", "template": "", "meta": { "_acf_changed": false, "inline_featured_image": false }, "class_list": [ "post-36", "attachment", "type-attachment", "status-inherit", "hentry" ], "acf": [], "lang": "en", "translations": { "en": 36, "fr": 9298, "es": 9306, "ar": 9314 }, "pll_sync_post": [], "description": { "rendered": "<p class=\"attachment\"><a href='https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt.jpg'><img decoding=\"async\" width=\"300\" height=\"176\" src=\"https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-300x176.jpg\" class=\"attachment-medium size-medium\" alt=\"\" srcset=\"https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-300x176.jpg 300w, https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-1024x602.jpg 1024w, https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-768x451.jpg 768w, https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-1536x902.jpg 1536w, https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt.jpg 1920w\" sizes=\"(max-width: 300px) 100vw, 300px\" /></a></p>\n" }, "caption": { "rendered": "" }, "alt_text": "", "media_type": "image", "mime_type": "image/jpeg", "media_details": { "width": 1920, "height": 1128, "file": "2024/06/home-image-opt.jpg", "filesize": 195319, "sizes": { "medium": { "file": "home-image-opt-300x176.jpg", "width": 300, "height": 176, "filesize": 18839, "mime_type": "image/jpeg", "source_url": "https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-300x176.jpg" }, "large": { "file": "home-image-opt-1024x602.jpg", "width": 1024, "height": 602, "filesize": 134639, "mime_type": "image/jpeg", "source_url": "https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-1024x602.jpg" }, "thumbnail": { "file": "home-image-opt-150x150.jpg", "width": 150, "height": 150, "filesize": 9371, "mime_type": "image/jpeg", "source_url": "https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-150x150.jpg" }, "medium_large": { "file": "home-image-opt-768x451.jpg", "width": 768, "height": 451, "filesize": 85834, "mime_type": "image/jpeg", "source_url": "https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-768x451.jpg" }, "1536x1536": { "file": "home-image-opt-1536x902.jpg", "width": 1536, "height": 902, "filesize": 243107, "mime_type": "image/jpeg", "source_url": "https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-1536x902.jpg" }, "medium-thumb-size": { "file": "home-image-opt-500x500.jpg", "width": 500, "height": 500, "filesize": 63891, "mime_type": "image/jpeg", "source_url": "https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt-500x500.jpg" }, "full": { "file": "home-image-opt.jpg", "width": 1920, "height": 1128, "mime_type": "image/jpeg", "source_url": "https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt.jpg" } }, "image_meta": { "aperture": "0", "credit": "", "camera": "", "caption": "", "created_timestamp": "0", "copyright": "", "focal_length": "0", "iso": "0", "shutter_speed": "0", "title": "", "orientation": "0", "keywords": [] } }, "post": 25, "source_url": "https://maforum.ippf.org/wp-content/uploads/2024/06/home-image-opt.jpg", "_links": { "self": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/media/36", "targetHints": { "allow": [ "GET", "POST", "PUT", "PATCH", "DELETE" ] } } ], "collection": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/media" } ], "about": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/types/attachment" } ], "author": [ { "embeddable": true, "href": "https://maforum.ippf.org/wp-json/wp/v2/users/1" } ], "replies": [ { "embeddable": true, "href": "https://maforum.ippf.org/wp-json/wp/v2/comments?post=36" } ] } }
    Image URL

    Choose what size you want. I think you should go with large, but you check how it all displays. media_details->sizes->large->source_url

2. Resource list

curl -X GET 'https://maforum.ippf.org/wp-json/wp/v2/map-resources?lang=en&page=1&per_page=10&search=abortion&category=Media%20Resources&region=belgium&res_type=Blog%20Post' \ --header 'x-connect-allow: string' \ --header 'Authorization: Bearer token'
[ { "id": 17456, "date": "2025-05-28T11:12:15", "date_gmt": "2025-05-28T11:12:15", "guid": { "rendered": "https://maforum.ippf.org/?post_type=map-resources&#038;p=17456" }, "modified": "2025-07-23T14:25:23", "modified_gmt": "2025-07-23T13:25:23", "slug": "10-abortion-with-pills-care-and-freedom-vs-control-and-force-for-trainings", "status": "publish", "type": "map-resources", "link": "https://maforum.ippf.org/map-resources/10-abortion-with-pills-care-and-freedom-vs-control-and-force-for-trainings/", "title": { "rendered": "10 &#8211; Abortion with Pills: Care and freedom vs control and force (for trainings)" }, "content": { "rendered": "\n<p>This video presents two different frames on opposition. On one side underlines the importance of providing care and support in contraposition with the antagonists that force people to give birth against their will. This video could be used mainly for training purposes rather than for a campaign as these frames are present separately in other videos.</p>\n\n\n\n<p>Abortion with Pills is a mini-video series about medical abortion.</p>\n\n\n\n<p>These videos are open-sourced and available with English and Italian voice-over + subtitles in English, Italian, Spanish, Portuguese (from Portugal), French, Russian, Polish, Romanian and Slovak.</p>\n\n\n\n<p>You can download, disseminate and use them in training.</p>\n\n\n\n<p><a href=\"https://api.movementaccelerator.org/api/files/922\">Check the Framing Abortion with Pills &#8211; short guide and the rest of the video series.</a></p>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https://maforum.ippf.org/wp-content/uploads/2025/05/941.mp4\"></video></figure>\n", "protected": false }, "featured_media": 17457, "template": "", "regions": [], "mapresources-category": [ 743 ], "ma-countries": [], "class_list": [ "post-17456", "map-resources", "type-map-resources", "status-publish", "has-post-thumbnail", "hentry", "mapresources-category-media-resources" ], "acf": [], "map_fimg_url": "https://maforum.ippf.org/wp-content/uploads/2025/05/884-scaled.jpg", "_links": { "self": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/map-resources/17456", "targetHints": { "allow": [ "GET", "POST", "PUT", "PATCH", "DELETE" ] } } ], "collection": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/map-resources" } ], "about": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/types/map-resources" } ], "wp:featuredmedia": [ { "embeddable": true, "href": "https://maforum.ippf.org/wp-json/wp/v2/media/17457" } ], "wp:attachment": [ { "href": "https://maforum.ippf.org/wp-json/wp/v2/media?parent=17456" } ], "wp:term": [ { "taxonomy": "regions", "embeddable": true, "href": "https://maforum.ippf.org/wp-json/wp/v2/regions?post=17456" }, { "taxonomy": "mapresources-category", "embeddable": true, "href": "https://maforum.ippf.org/wp-json/wp/v2/mapresources-category?post=17456" }, { "taxonomy": "ma-countries", "embeddable": true, "href": "https://maforum.ippf.org/wp-json/wp/v2/ma-countries?post=17456" } ], "curies": [ { "name": "wp", "href": "https://api.w.org/{rel}", "templated": true } ] } } ]
Title

title->rendered

Date

date_gmt

Image

Use the same method as the page header to get featured_media

3. Filtering

Use the search query parameter in the above request.

3.b. Theme

This does not work on the website either. I would just not put it in. But if you want, the values are hard coded ['Blog Post', 'Photo', 'Image Gallery', 'Video Blog']. Use res_type query parameter to filter.

3.c. Category

curl -X GET 'https://maforum.ippf.org/wp-json/wp/v2/mapresources-category?lang=en' \ --header 'x-connect-allow: string' \ --header 'Authorization: Bearer token'
[ { "id": 742, "name": "General Resources", "slug": "general-resources" }, { "id": 743, "name": "Media Resources", "slug": "media-resources" } ]
Name

Use name value to filter using category query parameter.

3.d. Regions

curl -X GET 'https://maforum.ippf.org/wp-json/wp/v2/regions-resources?lang=en' \ --header 'x-connect-allow: string' \ --header 'Authorization: Bearer token'
[ { "id": 751, "name": "belgium", "slug": "belgium" }, { "id": 810, "name": "bhutan", "slug": "bhutan" }, { "id": 799, "name": "chile", "slug": "chile" }, { "id": 798, "name": "colombia", "slug": "colombia" }, { "id": 760, "name": "croatia", "slug": "croatia" }, { "id": 804, "name": "ecuador", "slug": "ecuador" }, { "id": 794, "name": "finland", "slug": "finland" }, { "id": 774, "name": "france", "slug": "france" }, { "id": 802, "name": "germany", "slug": "germany" }, { "id": 812, "name": "Ghana", "slug": "ghana" }, { "id": 806, "name": "guatemala", "slug": "guatemala" }, { "id": 754, "name": "hungary", "slug": "hungary" }, { "id": 793, "name": "ireland", "slug": "ireland" }, { "id": 779, "name": "italy", "slug": "italy" }, { "id": 781, "name": "kenya", "slug": "kenya" }, { "id": 785, "name": "latvia", "slug": "latvia" }, { "id": 783, "name": "netherlands", "slug": "netherlands" }, { "id": 805, "name": "peru", "slug": "peru" }, { "id": 789, "name": "philippines", "slug": "philippines" }, { "id": 761, "name": "poland", "slug": "poland" }, { "id": 775, "name": "portugal", "slug": "portugal" }, { "id": 786, "name": "romania", "slug": "romania" }, { "id": 755, "name": "slovakia", "slug": "slovakia" }, { "id": 756, "name": "slovenia", "slug": "slovenia" }, { "id": 762, "name": "spain", "slug": "spain" } ]
Name

Use name value to filter using region query parameter.

19 August 2025