{"id":18840145,"url":"https://github.com/seothemes/hybrid-sample","last_synced_at":"2026-05-01T16:34:06.935Z","repository":{"id":87409707,"uuid":"92370865","full_name":"seothemes/hybrid-sample","owner":"seothemes","description":"A search engine optimized, mobile-first sample theme based on the Hybrid Framework.","archived":false,"fork":false,"pushed_at":"2017-06-02T05:40:54.000Z","size":495,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"sample","last_synced_at":"2024-12-30T09:29:11.878Z","etag":null,"topics":["accessibility","flexbox","gulp","hybrid-core","sass","schema-org","search-engine-optimization","wordpress-starter-theme","wordpress-theme"],"latest_commit_sha":null,"homepage":"https://demo.seothemes.net/hybrid-sample","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seothemes.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-25T06:09:35.000Z","updated_at":"2022-04-14T10:04:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"6d0a247a-c103-46c6-8fd6-34934add39f8","html_url":"https://github.com/seothemes/hybrid-sample","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/seothemes%2Fhybrid-sample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seothemes%2Fhybrid-sample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seothemes%2Fhybrid-sample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seothemes%2Fhybrid-sample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seothemes","download_url":"https://codeload.github.com/seothemes/hybrid-sample/tar.gz/refs/heads/sample","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239776257,"owners_count":19695069,"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":["accessibility","flexbox","gulp","hybrid-core","sass","schema-org","search-engine-optimization","wordpress-starter-theme","wordpress-theme"],"created_at":"2024-11-08T02:45:11.805Z","updated_at":"2026-01-29T05:30:16.883Z","avatar_url":"https://github.com/seothemes.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hybrid Sample Theme\n\nA search engine optimized, mobile-first, flexbox-based starter theme with a modern development workflow.\n\n**Demo** - [https://demo.seothemes.net/hybrid-sample](https://demo.seothemes.net/hybrid-sample)\n\n\n## Features\n\n* Fully responsive, lightweight menus with pure CSS menu-toggle buttons that combine into one mobile menu.\n* [Superfish](https://superfish.joelbirch.co/) menu for keyboard navigation and other accessibility enhancements.\n* Accessible skip links and *read more* links with descriptive screen-reader text.\n* Mobile-first, flexbox-based CSS with combined rules, selectors and media queries for the smallest minification possible.\n* Exhaustive, valid schema.org microdata.\n* Robust Gulpfile included for automatically compiling assets, optimizing images, i18n, theme zip packaging and more.\n* Sass/SCSS partials, variables, mixins and functions included.\n* Custom logo, header and background support with postMessage transport.\n* Custom colors with postMessage transport.\n* Front page Hero section widget area with custom background image or video upload.\n* Flexbox based footer widget areas that automatically adjust widths.\n* Full support for [Roots Soil](https://github.com/roots/soil) plugin.\n* Gravity forms CSS/SCSS reset.\n\n\n## Requirements\n\n* PHP \u003e 5.6 (PHP 7 recommended)\n* WordPress \u003e 4.7\n* Node.js \u003e 6.9\n* Gulp.js \u003e 3.9\n\n\n## Quick Installation\n\n1. Upload, install and activate the Hybrid Sample theme.\n2. Install and activate recommended plugins.\n3. *IMPORTANT:* Delete unwanted existing posts, pages, comments \u0026 widgets.\n4. Import demo content *(sample.xml)* with the **WordPress Importer**.\n5. Import widgets demo content *(widgets.wie)* with the **Widget Importer \u0026 Exporter** plugin.\n6. Create navigation menus from ***Appearance \u003e Menus***.\n7. Go to ***Appearance \u003e Customize \u003e Site Identity*** to upload a logo.\n8. Go to ***Appearamce \u003e Customize \u003e Header Media*** to upload hero image or video.\n9. Go to ***Appearance \u003e Customize \u003e Static Front Page*** and configure to your liking.\n10. Go to ***Appearance \u003e Customize \u003e Layout*** and configure to your liking.\n\n\n## Structure\n\n```shell\ntheme/  \n├── assets/\n│   ├── fonts/\n│   ├── images/\n│   ├── scripts/\n│   └── styles/\n├── comment/\n├── content/\n├── includes/\n├── languages/\n├── library/\n├── menu/\n├── sidebar/\n├── .editorconfig\n├── .gitmodules\n├── comments.php\n├── footer.php\n├── functions.php\n├── gulpfile.js\n├── header.php\n├── index.php\n├── license.md\n├── package.json\n├── README.md\n├── rtl.css\n├── screenshot.png\n├── style.css\n├── style.min.css\n└── style.min.css.map\n```\n\n\n## Development\n\nHybrid Sample includes [Gulp](http://gulpjs.com/) as a build tool and [npm](https://www.npmjs.com/) to manage front-end packages.\n\n\n### Install dependencies\n\nFrom the command line on your host machine, navigate to the theme directory then run `npm install`:\n\n```shell\n# @ themes/your-theme-name/\n$ npm install\n```\n\nYou now have all the necessary dependencies to run the build process.\n\n\n### Build commands\n\n* `gulp sass` — Compile, autoprefix and minify Sass files.\n* `gulp scripts` — Minify javascript files.\n* `gulp images` — Compress and optimize images.\n* `gulp watch` — Compile assets when file changes are made, start Browsersync\n* `gulp` — Default task - runs all of the above tasks.\n\n\n#### Additional commands\n\n* `gulp i18n` — Scan the theme and create a POT file in the languages/ directory.\n* `gulp zip` — Package theme into zip file for distribution.\n\n\n### Using Browsersync\n\nTo use Browsersync you need to update `dev_url` on line 43 of `gulpfile.js` to reflect your local development hostname.\n\nIf your local development URL is `my-site.dev`, update the file to read:\n\n```javascript\n...\n  var dev_url = 'my-site.dev',\n...\n```\n\n\n## Support\n\nPlease visit https://seothemes.net/support/ for theme support.\n\n\n## Recomended Plugins\n\nAfter you have activated the Hybrid Sample theme, a Recommended Plugins notice will appear in the WordPress dashboard. Click 'Begin installing plugins' and follow the steps to install and activate all of the plugins recommended by the theme. This theme recommends the following:\n\n* ### Simple Social Icons\n\t* Simple Social Icons is a lightweight easy to use social icon plugin that creates a new widget for displaying links to social media profiles.\n\n* ### Widget Importer \u0026 Exporter \u003ca name=\"wie\"\u003e\u003c/a\u003e\n\t* Widget Importer \u0026 Exporter makes it easy to import the theme demo widget content. Upon acitvation it will create a new settings page under ***Tools \u003e Widget Importer***. Simply upload the ***widgets.wie*** file included with the theme.\n\n* ### WP Featherlight\n\t* This plugin adds simple lightbox functionality to any WordPress `[gallery]` shortcode. No settings or configuration required, just simply create a gallery on any post or page and link the images to 'Media File' and the lightbox will be automatically applied.\n\n* ### WordPress Importer\n\t* Imports the theme demo content such as posts, pages, comments and more.\n\n\n## Import Demo Content\n\n***IMPORTANT: Delete any unwanted widgets, posts, pages and comments BEFORE importing demo content***\n\nOnce the recommended plugins have been installed it is safe to import the theme demo content and widget demo content. To import the content used in the Hybrid Sample theme demo site, navigate to ***Tools \u003e Import*** and then select ***WordPress \u003e Run***. This will take you to the **Import** settings page where you can upload the *sample.xml* file included with the theme.\n\n\n## Menus\n\nHybrid Sample includes two responsive menus by default with support for sub-menu items. These are called the **Primary Menu** and **Secondary Menu** and are displayed in the site-header section of the theme. The menu used in the demo should be imported with the theme demo content *(sample.xml)*, however WordPress sometimes has problems with importing menu items. If this occurs, please create your menus by navigating to ***Appearance \u003e Menus*** and configuring to your liking.\n\nHybrid Sample also supports a third menu in the site footer. The theme demo uses this menu to display links to social media profiles.\n\n\n## Widget Areas\n\nThis theme supports 3 default widget areas, Hero, Footer and Sidebar. To import the theme demo widget content, [follow the instructions](#wie) for using the ***Widget Importer \u0026 Exporter*** plugin above.\n\n* ### Hero\n\t* The hero widget area is displayed on the front page of the site. The background image or video can be set in the theme customizer under ***Appearance \u003e Customize \u003e Header Media***.\n\n* ### Footer\n\t* The footer widget area is a site-wide widget area displayed in the site footer. Widgets placed here will always be even widths and automatically adjust depending on the number of widgets.\n\n* ### Sidebar\n\t* The sidebar widget area is displayed on *Sidebar Left* and *Sidebar Right* page layouts.\n\n\n## Customization\n\nHybrid Sample makes it easy to customize the theme to your liking. All customizations are done via the WordPress customizer as recommended by WordPress.\n\n* ### Custom Logo\n\t* To upload your own custom logo, navigate to ***Appearance \u003e Customize \u003e Site Identity***. From the **Site Identity** section of the customizer panel you can upload your own logo and favicon.\n\n* ### Custom Header\n\t* To upload a custom header for the Hero section, navigate to ***Appearance \u003e Customize \u003e Header Media***. The **Header Media** section contains video upload, YouTube URL or image upload options.\n\n* ### Custom Background\n\t* To set a custom background image, navigate to ***Appearance \u003e Customize \u003e Background Image***. From here you can upload your own image and configure to your liking. You can also use a color instead by navigating to the **Colors** section. You can find some really great free textures to use [here](http://subtlepatterns.com).\n\n* ### Custom Colors\n\t* To customize the colors of your theme, navigate to ***Appearance \u003e Customize \u003e Colors*** and customize to your liking.\n\n\n## Optimization\n\nWe decided to leave out the theme optimization file that most of our themes include by default, instead we recommend the use of the amazing [Soil](https://github.com/roots/soil) plugin by the team at Roots. Hybrid Sample fully supports all of Soil's features by default, all you need to do is install and activate the plugin and your set. The only configuration required is if you are using Google Analytics, you will then need to add your own GA tracking code to the /includes/theme-functions.php file on line 30. Simply uncomment the `add_theme_support( 'soil-google-analytics', 'YOUR-GA-CODE' );` line and replace *YOUR-GA-CODE* with your own unique code.\n\n\n## CHANGELOG\n\n= 0.1.0 = 2017-06-02\n* Initial beta release","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseothemes%2Fhybrid-sample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseothemes%2Fhybrid-sample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseothemes%2Fhybrid-sample/lists"}