Giter Site home page Giter Site logo

quangtrongonline / oc-news Goto Github PK

View Code? Open in Web Editor NEW

This project forked from gergo85/oc-news

0.0 1.0 0.0 619 KB

This is the simple news and newsletter plugin for OctoberCMS.

Home Page: http://octobercms.com/plugin/indikator-news

License: MIT License

PHP 73.17% HTML 26.54% CSS 0.29%

oc-news's Introduction

News & Newsletter plugin

Plugin can be used for publishing news simply on the website. In contrary of blog, writing comments is not possible, but visitors can subscribe on a newsletter system. During publishing news posts are available not just on the website but you can send them via email to subscribed users.

Plugin is same like put together a blog and a newsletter plugin. The main difference is that it is simpler and contains only the most necessary functions. So this makes easier uploading new contents and inform visitors.

Main features

  • Managing posts
  • Managing nested categories
  • Managing subscribers
  • Support the SEO
  • Support the GDPR
  • Export & Import data
  • Statistics and graphs
  • Send newsletter
  • Detailed mail logs
  • Front-end forms
  • Back-end widgets
  • Available extensions
  • Innovative solutions

Statistics and graphs

  • Graph - Posts in this year
  • Graph - Posts in last year
  • List - TOP 20 view posts
  • List - TOP 10 longest posts
  • List - TOP 10 shortest posts
  • Graph - Mail events
  • Graph - Mail summary

Advanced SEO support

You can enable this feature on the Settings > CMS > News & Newsletter page. If you use it, you should replace the title and meta description tags with the following lines:

<title>{% if post.seo_title %}{{ post.seo_title }}{% elseif this.page.meta_title %}{{ this.page.meta_title }}{% else %}{{ this.page.title }}{% endif %}</title>
<meta name="description" content="{% if post.seo_desc %}{{ post.seo_desc }}{% elseif this.page.meta_description %}{{ this.page.meta_description }}{% else %}{{ this.page.description }}{% endif %}">
{% if post.seo_image %}<meta property="og:image" content="{{ post.seo_image|media }}">{% endif %}

Additional SEO Configuration

Additionally, the following has been introduced for better SEO

  • A canonical URL specification tag
  • The use of the default post image as the seo image
  • A list of meta keywords made up of from post category and tags, the user adds to their post.

Along side the snippet above, you can add the following code the head of your theme files.

 <link rel="canonical" href="{{ this.page.meta_canonical }}">
 <link rel="image_src" href="{{ this.page.meta_image_src|media }}">
 <meta name="keywords" content="{{ this.page.meta_keywords }}"> 

You should include the meta_image_src only you don't use the post seo image to avoid confusion.

Automatic statistics

You just add the "Post content" front-end component to the page, where the post appears. If you are logged in as administrator, the counter will not grow. It works any cases, when the visitors open the post details.

Preview feature

You just add the "Post content" front-end component to the current page. If you modify a news, the "Preview" link appears along the left of the delete icon. If you are logged in as administrator, you can read the hidden and draft news too.

Quick navigation

If you modify any content, one or two arrows appear along the right of the delete icon. There are the navigation links. You can simply go to the previous or next content.

Available widgets

You can use the following widgets on the back-end Dashboard:

  • Post statistics
  • Subscriber statistics
  • List of TOP posts
  • List of new posts

Available components

Use the Components > News panel in CMS menu. At this moment there are the following components:

  • Display posts
  • Post content
  • List categories
  • Subscriber form
  • Unsubscribe form

HTML template variables

For post

  • {{ posts }} - List of posts in array
  • {{ posts.render|raw }} - Build-in pagination
  • {{ post.title }} - Title of post
  • {{ post.slug }} - Slug of post
  • {{ post.image|media }} - Full url of post image
  • {{ post.introductory|raw }} - Summary of post
  • {{ post.content|raw }} - Content of post
  • {{ post.published_at }} - Published date of post
  • {{ post.categories }} - Categories of post
  • {{ post.tags }} - List of tags in array
  • {{ post.seo_title }} - SEO title
  • {{ post.seo_keywords }} - SEO keywords
  • {{ post.seo_desc }} - SEO description
  • {{ post.seo_image|media }} - Full url of image
  • {{ post.status }} - Status of post (1: published, 2: hide, 3: draft)
  • {{ post.featured }} - Is post featured? (1: yes, 2: no)
  • {{ post.next() }} - First post after current post
  • {{ post.prev() }} - Last post before current post

For category

  • {{ categories }} - List of categories in array
  • {{ category.name }} - Name of category
  • {{ category.slug }} - Slug of category
  • {{ category.image|media }} - Full url of category image
  • {{ category.content|raw }} - Content of category
  • {{ category.status }} - Status of post (1: published, 2: hide)
  • {{ category.hidden }} - Is category hidden? (1: yes, 2: no)

For user (Backend User) All attributes and methods available in Backend\Models\User are accesible via {{ post.user }}. Examples:

  • {{ post.user.first_name }} - Post author first name (attribute)
  • {{ post.user.email }} - Post author email (attribute)
  • {{ post.user.getFullNameAttribute }} - Post author full name (method)
  • {{ post.user.getAvatarThumb }} - Public path to author avatar (method)

Checkout the Backend\Models\User interface and attributes for all possibilities.

Mail template variables

  • {{ name }} - Name of subscriber
  • {{ email }} - E-mail of subscriber
  • {{ title }} - Title of post
  • {{ slug }} - Slug of post
  • {{ introductory }} - Introductory of post
  • {{ summary }} - Alias of introductory
  • {{ plaintext }} - Introductory without HTML elements
  • {{ content }} - Content of post
  • {{ image }} - Relative path of post image

You can customize the layout of emails in the Settings > Mail > Mail templates page.

Useful extensions

Supported plugins

Available languages

  • en - English
  • de - Deutsch
  • ru - Pу́сский
  • hu - Magyar
  • pl - Polski
  • pt - Português
  • vn - Vietnamese
  • zh-TW - Taiwanese, Traditional Chinese

Requirements

  • October CMS v1.0.420 or newer version.
  • AJAX Framework is needed for the subscription form to work.

Installation

  1. Go to the Settings > Updates & Plugins page in the Backend.
  2. Click on the Install plugins button.
  3. Type the News & Newsletter text in the search field.

Add back-end widgets

  1. Go to the Dashboard page in the Backend.
  2. Click on the Manage widgets > Add widget button.
  3. Select the any News widgets from the list.

Credits

oc-news's People

Contributors

gergo85 avatar timfoerster avatar fenn-cs avatar mrmlnc avatar matteotrubini avatar techmahall avatar elceka avatar quangtrongonline avatar buurro avatar xmelic8 avatar giorgionetg avatar dyadyavasya avatar alvaro-canepa avatar insamo avatar uzunhair avatar tomaszstrojny avatar leocantthinkofaname avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.