Aspect ratio selection for Facebook posts (like Instagram)#82
Merged
paulocastellano merged 8 commits intoJun 10, 2026
Merged
Conversation
Facebook feed posts now have the same aspect ratio selector as Instagram (1:1, 4:5, 16:9, Original), letting users control how their image is cropped before publishing instead of leaving it to Facebook's auto-crop. The Facebook Graph API has no crop/aspect-ratio parameter for organic Page photo posts (image crops are ads-only) — Facebook displays the bytes it receives at their native ratio. So, exactly like Instagram, the crop is done server-side before upload. - Extract the Instagram crop logic into a shared CropsImageForAspectRatio concern (download -> crop -> store -> URL), with a per-publisher cropFailureException hook. InstagramPublisher refactored to use it (behaviour identical; existing tests unchanged). - FacebookPublisher reads meta.aspect_ratio and crops single- and multi-image feed posts (facebook-crops/ prefix). Reels/Stories are unaffected. - FacebookSettings: aspect ratio picker on the Feed variant (default Original -> no crop). ScheduleTab wires meta; FacebookPreview reflects the chosen ratio. Adds posts.form.facebook.aspect.* in en/es/pt-BR. Closes #69
- CropsImageForAspectRatio: drop the per-publisher path-prefix argument; crops from both platforms go to a single `social-crops/` directory (the folder has no functional meaning — the platform fetches by URL and nothing reads it back; UUID filenames prevent collisions). - Close the IG/FB test asymmetry surfaced in review: Instagram single-image crop now runs across 1:1/4:5/16:9 (dataset) and has a crop-download-failure test; Facebook gains an explicit 'original' bypass test. Both platforms now cover the same matrix (crop per ratio + uploaded-URL is the crop, original/no-meta bypass, multi-image, download-failure exception). Follow-up tracked in #83 (orphaned crops are never pruned from storage).
- Instagram carousel and Facebook multi-image crop tests now run as datasets over 1:1 and 4:5, asserting each image's real cropped ratio (previously 1:1 only) — proving the chosen ratio flows through the multi-image paths. - Add a Facebook test that a multi-image post aborts entirely (throws FacebookPublishException) when one image can't be downloaded for cropping.
…ok-posts-like-instagram
…ok-posts-like-instagram
…abs including preview, schedule, and comments functionalities
…chedule tab visibility logic
…ok-posts-like-instagram
paulocastellano
deleted the
69-feature-aspect-ratio-selection-for-facebook-posts-like-instagram
branch
paulocastellano
added a commit
to Falconiere/trypost
that referenced
this pull request
Jun 10, 2026
PR trypostit#82 made `meta.aspect_ratio` crop Facebook (and already Instagram) feed images at publish time, but the API and MCP surfaces only half-supported it: you couldn't set meta at creation, the value wasn't validated, and responses never returned it. This closes those gaps. - New `AspectRatio` enum is the single source of truth for the allowed ratios (1:1, 4:5, 16:9, original). App/API/MCP requests now validate via `Rule::enum(AspectRatio::class)` — an invalid ratio is rejected everywhere instead of silently center-cropping to square. - API `StorePostRequest` and MCP `CreatePostTool` now accept `platforms.*.meta`; `CreatePost` persists it. MCP create documents `meta` in its schema. - `Api\PostPlatformResource` now exposes `meta`, so API and MCP responses return the aspect_ratio (and other per-platform meta) a client set.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #69
What
Facebook feed posts now have the same aspect ratio selector as Instagram — 1:1, 4:5, 16:9, Original — so users control how their image is cropped before publishing, instead of leaving it to Facebook's auto-crop. This matters for accounts posting photography/exhibition content where composition matters.
Why it works this way (API analysis)
The reporter assumed the Facebook Graph API exposes aspect ratios. It doesn't for organic Page posts:
POST /{page-id}/photos) has no crop or aspect-ratio parameter — only the image source + metadata.So the only way to control the crop — exactly like Instagram already does — is to crop server-side before upload. No new Facebook API surface is involved.
How
CropsImageForAspectRatio(new concern) — the crop logic (download →MediaOptimizer::cropToAspectRatio→ store → public URL) extracted fromInstagramPublisher, with a per-publishercropFailureExceptionhook so each throws its own typed exception.InstagramPublisher— refactored onto the concern. Behaviour identical; the existing 25 IG tests pass unchanged (the refactor's safety net).FacebookPublisher— readsmeta.aspect_ratioand crops single- and multi-image feed posts (stored underfacebook-crops/). Reels/Stories (video) are untouched.FacebookSettingsshows the picker on the Feed variant (default Original → no crop, matching FB's native-ratio behaviour);ScheduleTabwires:meta/@update:meta;FacebookPreviewreflects the chosen ratio (falls back to the current fill layout when Original/unset).posts.form.facebook.aspect.*in en / es / pt-BR.Validation needs no change:
platforms.*.meta.aspect_ratiois already platform-agnostic.Tests
New in
FacebookPublisherTest:facebook-crops/) is what's uploaded, not the source.FacebookPublishException.Full suite: 1689 passed, 2 skipped (pre-existing, font-dependent). Pint + ESLint clean.