fictioneer/fictioneer-child-theme
1
0
Fork 0
mirror of https://gh.llkk.cc/https://github.com/Tetrakern/fictioneer-child-theme.git synced 2025-10-04 18:31:00 +08:00
Code Issues Projects Packages Wiki Activity Actions

Update README.md

Browse source
This commit is contained in:
Tetrakern 2023-11-25 02:42:02 +01:00
parent 0b0c2ecbd8
commit e211599b37
1 changed files with 4 additions and 65 deletions
Download patch file Download diff file Expand all files Collapse all files

69
README.md
View file

@ -6,16 +6,14 @@ A blank WordPress child theme for [Fictioneer](https://github.com/Tetrakern/fict

Some common examples of customization that have come up in the past. If you want to know more, take a look at the [action](https://github.com/Tetrakern/fictioneer/blob/main/ACTIONS.md) and [filter](https://github.com/Tetrakern/fictioneer/blob/main/FILTERS.md) references in the main repository. You are expected to know the basics of CSS, HTML, and coding (PHP) or consult one of the many free tutorials on the matter just a quick Internet search away.

* [Limit the Blog shortcode to specific roles](#limit-the-blog-shortcode-to-specific-roles)
* [Add site title or logo above main navigation](#add-site-title-or-logo-above-main-navigation)
* [Remove selected fields from the editor](#remove-selected-fields-from-the-editor)
* [Scope the Blog shortcode to specific roles](#scope-the-blog-shortcode-to-specific-roles)

### Limit the Blog shortcode to specific roles
### Scope the Blog shortcode to specific roles

Put the following into your `functions.php`.

```php
function child_limit_blog_shortcode_to_roles( $query_args ) {
function child_scope_blog_shortcode_to_roles( $query_args ) {
# Optional: Only apply the filter to a specific page, etc.
if ( ! is_page( 'your-page-slug' ) ) {
return $query_args;
@ -33,64 +31,5 @@ function child_limit_blog_shortcode_to_roles( $query_args ) {
# Step 4: Return modified query arguments
return $query_args;
}
add_filter( 'fictioneer_filter_shortcode_blog_query_args', 'child_limit_blog_shortcode_to_roles', 10 );
```

### Add site title or logo above main navigation

Put the following into your `functions.php` to add custom HTML above the main navigation.

```php
function child_add_identity_above_navigation( $args ) {
?>
<div class="child-navigation-identity">Site Title/Logo</div>
<?php
}
add_action( 'fictioneer_navigation_top', 'child_add_identity_above_navigation' );
```

Put the following custom CSS into your theme style file. Note that this example is just the foundation and not ready to be used, you will need to adjust the style to your needs, account for mobile viewports, etc.

```css
body {
/* Offsets the stickiness point of the navigation on mobile! */
--nav-observer-offset: 32px; /* Replace with mobile height of the new element! */
}

@media only screen and (min-width: 1024px) {
body {
/* Offsets the stickiness point of the navigation on desktop! */
--nav-observer-offset: 64px; /* Replace with desktop height of the new element! */
}
}

.main-navigation {
margin-top: 0 !important; /* This is now covered by the new element! */
}

/* Mobile */
.child-navigation-identity {
/* Adjust as needed! */
padding: 12px 10px 10px 16px;
margin: 0 auto;
max-width: var(--site-width);
height: 32px;
}

/* Desktop */
@media only screen and (min-width: 1024px) {
.child-navigation-identity {
/* Adjust as needed! */
height: 64px;
}
}
```

You can hide the default logo or site title by just not adding any or disabling it. If you want to remove the default header (including the header image) completely, put the following into your `functions.php`.

```php
function child_remove_default_header() {
remove_action( 'fictioneer_site', 'fictioneer_site_header', 20 );
}
add_action( 'init', 'child_remove_default_header' );
add_filter( 'fictioneer_filter_shortcode_blog_query_args', 'child_scope_blog_shortcode_to_roles', 10 );
```