{"id":15646210,"url":"https://github.com/laras126/content-blocks","last_synced_at":"2025-04-30T12:02:39.594Z","repository":{"id":149535862,"uuid":"26230682","full_name":"laras126/content-blocks","owner":"laras126","description":"A content strategy for WordPress built with Timber and Advanced Custom Fields.","archived":false,"fork":false,"pushed_at":"2015-10-08T16:59:53.000Z","size":3335,"stargazers_count":49,"open_issues_count":0,"forks_count":3,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-30T15:51:16.254Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/laras126.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-11-05T17:19:23.000Z","updated_at":"2024-12-21T02:33:14.000Z","dependencies_parsed_at":"2023-04-09T06:55:47.791Z","dependency_job_id":null,"html_url":"https://github.com/laras126/content-blocks","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laras126%2Fcontent-blocks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laras126%2Fcontent-blocks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laras126%2Fcontent-blocks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laras126%2Fcontent-blocks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/laras126","download_url":"https://codeload.github.com/laras126/content-blocks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251697270,"owners_count":21629391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-03T12:11:52.501Z","updated_at":"2025-04-30T12:02:39.536Z","avatar_url":"https://github.com/laras126.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Content Blocks FTW\n\nContent Blocks are a content strategy for WordPress built with [Timber](https://github.com/jarednova/timber/) and [Advanced Custom Fields](http://advancedcustomfields.com). No longer shall we create our WordPress sites with HTML in the content editor! Let's fill out nice fields and separate our concerns instead of adding `\u003cbr\u003e`s everywhere. C'mon, we all do.\n\n### Naming Conventions\n\nAll views prefixed with an `_` are extending something. Views partials, Sass partials, and ACF field names are mapped one to one for the most part.\n\n### Blocks\n\nBlocks are structured chunks of content that remove the need for messy markup interspersed with your content. They are built using ACF Pro's Flexible Content Field.\n\n#### `block_text`\n\nGeneral text block. Can be for large blocks of writing and contains options for headings.\n\n- `block_text` - WYSIWYG, Text Only toolbar\n\n#### `block_textimage`\n\nDisplay text next to an image. Can be a larger image with a caption or inline with the text.\n\n- `textimage_format` - Radio, `caption` or `paragraph`\n- `textimage_paragraph` - WYSIWYG, Text Only toolbar\n- `textimage_caption` - Textarea (should it be WYSIWYG with Link Only)?\n- `textimage_image` - Image\n\n#### `block_list`\n\nBlock for either a free form list of content with an item description, title, and image OR a list of connected content. The connected content will display its featured image, post title, and excerpt.\n\n- `list_title` - Text\n- `list_type` - Radio, `free_form` or `connected_content`\n- `list_display` - Radio, `major` or `minor`\n- if `free_form`\n\t- `list_type_freeform` - Repeater\n\t\t- `item_title` - Text\n\t\t- `item_description` - WYSIWG Link Only\n\t\t- `item_image` - Image\n- if `connected_content`\n\t- `list_type_connected_content` - Relationship\n\n#### `block_quote`\n\nFor blockquotes or testimonials.\n\n- `quote_text` - Textarea\n- `quote_source` - Text\n- `quote_source_url` - URL\n\n#### `block_cta`\n\nCall to action containing a button.\n\n- `cta_text` - Text\n- `cta_btn_text` - Text\n- `cta_btn_url` - URL\n\n#### `block_html`\n\nFor standard markup or shortcodes.\n\n- `html` - WYSIWG text only, no formatting.\n\n### Base Views\n\nEach directory of views contains a base view that is extended by its variations e.g. `block.twig` is extended by `_block-text.twig`. These are then included in primary templates with context variables. The following notes document the context variables each base template accepts.\n\n(Is this too abstracted? Whatever, it's fun.)\n\n#### `headers/header.twig`\nContains 3 context variables (is that the correct term?):\n1. `contain`: Conditionall prints a container within the `\u003cheader\u003e` tags. Takes a string for the class name, should be `contain-[size]`.\n2. `class`: And class names for the `\u003cheader\u003e`. Should be BEMmy (I think), like `header--site`.\n3. `role`: An ARIA role if necessary. Just the text for the role, so `banner`, etc.\n\n#### `blocks/block.twig`\n...\n\n#### `teases/tease.twig`\n...\n\n#### `pages/page.twig`\n...\n\n#### `singles/single.twig`\n...\n\n#### `footers/footer.twig`\n...\n\n## Getting Started\n\nComing soon.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaras126%2Fcontent-blocks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flaras126%2Fcontent-blocks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaras126%2Fcontent-blocks/lists"}