Plugin Directory

Changeset 2676385


Ignore:
Timestamp:
02/10/2022 01:35:46 PM (4 years ago)
Author:
Lugat
Message:

readme

File:
1 edited

Legend:

Unmodified
Added
Removed
  • jinx-fast-cache/trunk/readme.txt

    r2676369 r2676385  
    1616It will generate static HTML files which will be called using your apaches rewrite rules.
    1717This feature will bypass the whole PHP process and render only a simple HTML file without the whole overhead.
    18 Also there is no real admin panel, but you may use some filters to change the behavior.
    1918
    2019== Installation ==
     
    2625== Usage ==
    2726
    28 After activating the plugin, it will modify your htaccess file. If this is not possible, make sure the enter the rules by yourself:
     27After activating the plugin, it will modify your htaccess file. If this is not possible, make sure to enter the rules by yourself:
    2928
    3029    # BEGIN Jinx Fast-Cache
     
    3837When using nginx, make sure to add the following rules:
    3938
    40 
    4139    set $cache_path false;
    4240    if ($request_method = GET) {
     
    4947You may flush, warm or refresh (flush & warm) single or multiple URLs using the buttons in the admin bar.
    5048
    51 By default all posts will be automatically be warmed after they have been saved and flushed after they have been deleted or put on draft.
     49By default all posts will be automatically warmed after they have been saved and flushed after they have been deleted or put on draft.
    5250
    5351The warm process will create a queue which will be handled in a scheduled task (cron). When warming up a single post, it will skip the queue.
     
    5957Jinx Fast-Cache is made for developers. So far no admin panel is available, but you may modify a lot of it's behaviors using filters.
    6058
    61 * jinx_fast_cache: Return true (default) or false to control, if a URL should be cache or not.
    62 * jinx_fast_cache_post_types: Control the post types which should be cached. By default all post types which are "publicly_queryable" and "page" will be cached.
    63 * jinx_fast_cache_posts: Filter the posts which should be cached.
    64 * jinx_fast_cache_taxonomies: Control the taxonomies which should be cached. By default all taxonomies which are "publicly_queryable" will be cached.
    65 * jinx_fast_cache_terms: Filter the terms which should be cached.
    66 * jinx_fast_cache_output: Use this to modify the HTML content written to your cache file.
    67 * jinx_fast_cache_minify: Return true (default) or false if you want the output to be minified.
    68 * jinx_fast_cache_flush: Control which URLs should be flushed. This may be used to flush related URLs eg. your front page.
    69 * jinx_fast_cache_warm: Control which URLs should be warmed. This may be used to warm related URLs eg. your front page.
    70 * jinx_fast_cache_interval: Change the interval of the cron task (default 60).
    71 * jinx_fast_cache_queue_size: Change the number of URLs which should be handled durring a cron task (default 10). When setting it to <= 0, all URLs will be handled. This may cause a huge load when you have a lot of URLs.
     59- **jinx_fast_cache**: Return true (default) or false to control, if a URL should be cache or not.
     60- **jinx_fast_cache_post_types**: Control the post types which should be cached. By default all post types which are "publicly_queryable" and "page" will be cached.
     61- **jinx_fast_cache_posts**: Filter the posts which should be cached.
     62- **jinx_fast_cache_taxonomies**: Control the taxonomies which should be cached. By default all taxonomies which are "publicly_queryable" will be cached.
     63- **jinx_fast_cache_terms**: Filter the terms which should be cached.
     64- **jinx_fast_cache_output**: Use this to modify the HTML content written to your cache file.
     65- **jinx_fast_cache_minify**: Return true (default) or false if you want the output to be minified.
     66- **jinx_fast_cache_flush**: Control which URLs should be flushed. This may be used to flush related URLs eg. your front page.
     67- **jinx_fast_cache_warm**: Control which URLs should be warmed. This may be used to warm related URLs eg. your front page.
     68- **jinx_fast_cache_interval**: Change the interval of the cron task (default 60).
     69- **jinx_fast_cache_queue_size**: Change the number of URLs which should be handled durring a cron task (default 10). When setting it to <= 0, all URLs will be handled. This may cause a huge load when you have a lot of URLs.
    7270
    7371=== Injections ===
     
    7573Jinx Fast-Cache also provides the feature to inject dynamic content parts. If you eg. want to print the users name on the page, you may inject it via ajax.
    7674
    77 Note that the first parameter is the placeholder content. This will prevent any problems when calling the action without the plugin beeing active. You may use it load the template normally or print a note like "loading ...".
     75Note that the first parameter is the placeholder content. This will prevent any problems when calling the action without the plugin beeing active. You may load the template normally or print a note like "loading ...".
    7876
    7977Inject a template:
     
    8179    do_action('jinx_fast_cache_inject_template', null, 'user');
    8280
    83 
    8481This has the same result as:
    8582
    8683    do_action('jinx_fast_cache_inject', null, 'get_template_part', ['user']);
    87 
    8884
    8985You may call every public function of PHP, your theme or plugin:
     
    9490    do_action('jinx_fast_cache_inject', null, ['namespace\MyClass', 'myMethod'], ['param1', 'param2']);
    9591
    96 
    9792== Roadmap ==
    9893
    99 * [x] Release it
    100 * [x] Add HTML minification for output
    101 * [x] Allow injection of dynamic rendered templates using ajax requests
    102 * [x] Add taxonomies
    103 * [x] Provide scheduled tasks
    104 * [x] Add admin columns for cache status
    105 * [ ] Provide exclude option for posts and terms in backend
    106 * [x] Add multisite support
    107 * [ ] Provide cache timeout
    108 * [ ] Provide admin panel to change options
     94- [x] Release it
     95- [x] Add HTML minification for output
     96- [x] Allow injection of dynamic rendered templates using ajax requests
     97- [x] Add taxonomies
     98- [x] Provide scheduled tasks
     99- [x] Add admin columns for cache status
     100- [ ] Provide exclude option for posts and terms in backend
     101- [x] Add multisite support
     102- [ ] Provide cache timeout
     103- [ ] Provide admin panel to change options
Note: See TracChangeset for help on using the changeset viewer.