Skip to content

AnkitSharma-007/blogsite

Repository files navigation

Overview

Prerequisites

Install the following software.

Create a new Angular app

Run the command shown below to create a new Angular app named as blogsite.

ng new blogsite --routing=false --style=scss

Open Visual Studio Code

Change directory to the new project and open the project in VS Code.

cd blogsite
code .

Configuring firebase

We will create a project on firebase and configure cloud firestore database for it. We will use this database for our angular application. The steps are shown below.

Creating a project on firebase

To create a new project on firebase follow the steps mentioned below.

  • Navigate to https://console.firebase.google.com/ and login using your Gmail account.
  • Click on “Create a Project” button.
  • Enter you project name. You can give any name of your choice. Here we will use the name ngBlog.
  • Accept the terms and click on Continue.
  • If asked to setup Google Analytics, select “Not right now”
  • Click on “Create your project”.
  • Once the project is ready click Continue.

Add Firebase configuration to your application

Create "Cloud Firestore" database

  • Navigate to the "Project Overview" page of your Firebase project.
  • Select “Database” under “Develop” menu from the list on the left.
  • Click on “Create database” button.
  • Select “Start in test mode”. Click "Next". Click “Done” The Cloud Firestore database is now configured for your Firebase project.

Install @angular/fire and firebase

Run the command shown below in the command prompt

npm install firebase @angular/fire --save

Import the libraries in src/app/app.module.ts as shown below.

import { AngularFireModule } from '@angular/fire';
import { AngularFirestoreModule } from '@angular/fire/firestore';

@NgModule({
...
imports: [
    // other imports
    AngularFireModule.initializeApp(environment.firebaseConfig),
    AngularFirestoreModule,
  ],
...
})

Install Angular Material packages

Execute the following command in the console.

npm install --save @angular/material @angular/cdk @angular/animations

After installation import it into src/app/app.module.ts file as shown below.

import {BrowserAnimationsModule} from '@angular/platform-browser/animations';

@NgModule({
  ...
  imports: [
    ...
    BrowserAnimationsModule,
  ],
})

Some features of Angular material require HammerJS. Install it using the command shown below.

npm install --save hammerjs

After installation import it into src/main.ts. This file is the entry point of our app.

import 'hammerjs';

Add a material theme

We will add a built-in material theme globally by including the following line in src/styles.scss file.

@import  "~@angular/material/prebuilt-themes/indigo-pink.css";

Add a module for Angular material

We will create a new module to include all the material related components. Run the following command in the console to create a new module.

ng g m ng-material

Open src/app/ng-material/ng-material.module.ts and replace what is there with the code in https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/ng-material/ng-material.module.ts

Import this new NgMaterialModule in src/app/app.module.ts file as shown below.

import { NgMaterialModule } from  './ng-material/ng-material.module';

@NgModule({
  ...
  imports: [
    ...
    NgMaterialModule,
  ],
})

Add Bootstrap CSS package

Run the following command to install Bootstrap in your app.

npm install bootstrap --save

Include the reference of Bootstrap globally in src/styles.scss file as shown below.

@import  "~bootstrap/dist/css/bootstrap.css";

Serve the application

Open a new terminal window and run the following command.

ng serve

The CLI will now serve the application at localhost:4200 and recompile and reload whenever a file changes.

Add Navigation Bar

Run the following command, in the original terminal, to generate a navigation bar component.

ng g c components/nav-bar

Open src/app/components/nav-bar/nav-bar.component.html and replace what is there with the following code.

<mat-toolbar class="nav-bar mat-elevation-z2"></mat-toolbar>

We will add the styling for nav bar in src/app/components/nav-bar/nav-bar.component.scss as shown below

 .nav-bar {
    background-color: #1565C0;
    color: #FFFFFF;
    position: fixed;
    top: 0;
    z-index: 99;
  }

  button:focus {
    outline: none;
    border: 0;
  }

Create the Home Page

Run the following command to create the HomeComponent

ng g c components/home

At this point in time we will not add any code to HomeComponent. We will revisit it in a later part of this workshop.

Add Router module

We will add the RouterModule into src/app/app.module.ts as shown below.

import { RouterModule } from '@angular/router';

@NgModule({
  ...    
  imports: [
    ...
    RouterModule.forRoot([
      { path: '', component: HomeComponent, pathMatch: 'full' },
      { path: '**', component: HomeComponent }
    ]),
  ],
})

Update the AppComponent

Open src/app/app.component.html and replace the content of the file with the following code.

<app-nav-bar></app-nav-bar>
<div class="container">
  <router-outlet></router-outlet>
</div>

Add the following styles to src/styles.scss

body {
  background-color: #fafafa;
}

.container {
  padding-top: 60px;
}

Add Forms module

We will add the FormsModule in src/app/app.module.ts as shown below.

import { FormsModule } from  '@angular/forms';

@NgModule({
  ...    
  imports: [
    ...
    FormsModule,
  ],
})

Creating the data model

Create new a folder src/app/models. Create a new file src/app/models/post.ts and paste the following code

export class Post {
    postId: string;
    title: string;
    content: string;
    createdDate: any;
    
	    constructor() {
	    this.content = '';
    }
}

Create the blog service

We will create a service to handle our the database operation. Create a new service using the command shown below.

ng g s services/blog

Open the src/app/services/blog.service.ts file and add the following import definitions.

import { AngularFirestore } from  '@angular/fire/firestore';
import { Post } from  '../models/post';
import { map } from  'rxjs/operators';
import { Observable } from  'rxjs';

Inject the AngularFirestore in the constructor.

constructor(private db: AngularFirestore) { }

Now we will add the method to create a new post. The method to add a new blog post is shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/services/blog.service.ts#L14-L17. Put this method in blog.service.ts file.

createPost(post: Post) {
  const postData = JSON.parse(JSON.stringify(post));
  return this.db.collection('blogs').add(postData);
}

Install CkEditor package

We will use CKEditor for adding and editing our blog post. CKEditor is a Smart WYSIWYG editor which provides us great editing capabilities.

Execute the commands shown below to install the CKEditor WYSIWYG editor component for Angular.

npm install --save @ckeditor/ckeditor5-angular

Run the command shown below to install one of the official editor builds which is classic editor.

npm install --save @ckeditor/ckeditor5-build-classic

Imports the CKEditorModule in src/app/app.module.ts as shown below.

import { CKEditorModule } from '@ckeditor/ckeditor5-angular';

@NgModule( {
  imports: [
    ...
    CKEditorModule,
  ],
})

Add the blog editor

We will create a new component for adding and editing the blog. Run the command as shown below.

ng g c components/blog-editor

Add a route to the addpost page

Add the route for this component in app.module.ts as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/app.module.ts#L50

RouterModule.forRoot([
  ...
  { path: 'addpost', component: BlogEditorComponent },
  ...
])

Add CKEditor to BlogEditorComponent

Open src/app/components/blog-editor/blog-editor.component.ts and add the import definitions as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-editor/blog-editor.component.ts#L2-L6

import * as ClassicEditor from '@ckeditor/ckeditor5-build-classic';
import { Post } from 'src/app/models/post';
import { DatePipe } from '@angular/common';
import { BlogService } from 'src/app/services/blog.service';
import { Router, ActivatedRoute } from '@angular/router';

We will also initialize some properties as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-editor/blog-editor.component.ts#L16-L20

public Editor = ClassicEditor;
ckeConfig: any;
postData = new Post();
formTitle = 'Add';
postId = '';

We will create a method to define the configuration for the blog editor. You can get the method definition from https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-editor/blog-editor.component.ts#L50-L66

setEditorConfig() {
  this.ckeConfig = {
    removePlugins: ['ImageUpload', 'MediaEmbed'],
    heading: {
      options: [
        { model: 'paragraph', title: 'Paragraph', class: 'ck-heading_paragraph' },
        { model: 'heading1', view: 'h1', title: 'Heading 1', class: 'ck-heading_heading1' },
        { model: 'heading2', view: 'h2', title: 'Heading 2', class: 'ck-heading_heading2' },
        { model: 'heading3', view: 'h3', title: 'Heading 3', class: 'ck-heading_heading3' },
        { model: 'heading4', view: 'h4', title: 'Heading 4', class: 'ck-heading_heading4' },
        { model: 'heading5', view: 'h5', title: 'Heading 5', class: 'ck-heading_heading5' },
        { model: 'heading6', view: 'h6', title: 'Heading 6', class: 'ck-heading_heading6' },
        { model: 'Formatted', view: 'pre', title: 'Formatted' },
      ]
    }
  };
}

We will invoke this method inside ngOnInit as shown below.

ngOnInit() {
  this.setEditorConfig();
}

Update the BlogEditorComponent template

Open src/app/components/blog-editor/blog-editor.component.html and put the code as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-editor/blog-editor.component.html

<h1>{{formTitle}} Post</h1>
<hr />
<form #myForm="ngForm" (ngSubmit)="myForm.form.valid && saveBlogPost()" accept-charset="UTF-8" novalidate>
    <input type="text" class="blogHeader" placeholder="Add title..." class="form-control" name="postTitle"
        [(ngModel)]="postData.title" #postTitle="ngModel" required />
    <span class="text-danger" *ngIf="myForm.submitted && postTitle.errors?.required">
        Title is required
    </span>
    <br />
    <div class="form-group">
        <ckeditor name="myckeditor" [config]="ckeConfig" [(ngModel)]="postData.content" #myckeditor="ngModel"
            debounce="300" [editor]="Editor"></ckeditor>
    </div>
    <div class="form-group">
        <button type="submit" mat-raised-button color="primary">Save</button>
        <button type=" button" mat-raised-button color="warn" (click)="cancel()">CANCEL</button>
    </div>
</form>

Add a new blog

We will now implement the feature of adding a new blog to our application. Open src/app/components/blog-editor.component.ts and inject the following service definitions in the constructor.

constructor(private  _route: ActivatedRoute,
  private  datePipe: DatePipe,
  private  blogService: BlogService,
  private  _router: Router) { }

Add the following code in @Component decorator DatePipe can be injected.

@Component({
  ...
  providers: [DatePipe]
}

We will create a new method called saveBlogPost which is used to add a new post to our database. The definition for this method is shown below.

saveBlogPost() {
  this.postData.createdDate = this.datePipe.transform(Date.now(), 'MM-dd-yyyy HH:mm');
  this.blogService.createPost(this.postData).then(
    () => {
    this._router.navigate(['/']);
    }
  );
}

This method will be invoked on click of Save button. We will add the following code definition for Cancel button.

cancel() {
	this._router.navigate(['/']);
}

Add buttons in Nav bar

We will add the navigation button to blog editor and home page in the nav bar. Add the following code to the <mat-toolbar> element in src/app/components/nav-bar/nav-bar.component.html.

<button mat-button [routerLink]='[""]'> My blog </button>
<button mat-button [routerLinkActive]='["link-active"]' [routerLink]='["/addpost"]'>
    Add Post
</button>
<span  class="spacer"></span>

Add BlogEditorComponent styles

We will add styling for blog editor in styles.scss file as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/styles.scss#L14-L47

.ck-editor__editable {
  max-height: 350px;
  min-height: 350px;
}

pre {
  display: block;
  padding: 9.5px;
  margin: 0 0 10px;
  font-size: 13px;
  line-height: 1.42857143;
  color: #333;
  word-break: break-all;
  word-wrap: break-word;
  background-color: #f5f5f5;
  border: 1px solid #ccc;
  border-radius: 4px;
}

blockquote {
  display: block;
  padding: 10px 20px;
  margin: 0 0 20px;
  font-size: 17.5px;
  border-left: 5px solid #eee;
}

img{
  max-width: 100%;
}

.spacer {
  flex: 1 1 auto;
}

Test it out

Open the browser and click on “AddPost” button on the nav-bar. You will be navigated to the blog editor page. Add a new blog and click on save button to save the blog in the database. Open the firebase console, navigate to your project overview page and click on “Database” link in the menu on the left. Here you can see the record for your newly added blog.

Create custom pipes

We will add two custom pipes in our app

  • Excerpt: which will show a summary of post in blog card.
  • Slug: which will show the URL slug for a post.

Run the following command to generate the excerpt pipe.

ng g p custompipes/excerpt

Replace the transform method with the following code, as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/custompipes/excerpt.pipe.ts#L5-L12

transform(content: string) {
  const postSummary = content.replace(/(<([^>]+)>)/ig, '');
  if (postSummary.length > 300) {
    return postSummary.substr(0, 300) + ' [...]';
  } else {
    return postSummary;
  }
}

Run the following command to generate the slug pipe.

ng g p custompipes/slug

Replace the transform method with the following, as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/custompipes/slug.pipe.ts#L5-L8

transform(title: string) {
  const urlSlug = title.trim().toLowerCase().replace(/ /g, '-');
  return urlSlug;
}

Get the blogs from database

We will add the getAllPosts method in src/app/services/blog.service.ts file to fetch all the blog posts from database. The definition for getAllPosts is shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/services/blog.service.ts#L19-L29

getAllPosts(): Observable<any> {
  const blogs = this.db.collection('blogs', ref => ref.orderBy('createdDate', 'desc')).snapshotChanges().pipe(
    map(actions => {
      return actions.map(
        c => ({
          postId: c.payload.doc.id,
          ...c.payload.doc.data()
        }));
    }));
  return blogs;
}

Add a BlogCardComponent

Run the command shown below to create the blog card component.

ng g c components/blog-card

Open src/app/components/blog-card.component.ts and add the following imports

import { BlogService } from 'src/app/services/blog.service';
import { Post } from 'src/app/models/post';

Inject the Blog Service in the constructor of BlogCardComponent class as shown below.

constructor(private blogService: BlogService) { }

Add a property to hold the current blog post.

blogPost: Post[] = [];

Now we will create a method to get the blog post and invoke it inside ngOnInit in src/app/components/blog-card.component.ts file.

ngOnInit() {
  this.getBlogPosts();
}

getBlogPosts() {
  this.blogService.getAllPosts().subscribe(result => {
    this.blogPost = result;
  });
}

Open src/app/components/blog-card.component.html and replace what is there with the HTML shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-card/blog-card.component.html#L1-L29

Open src/app/components/blog-card/blog-card.component.scss and replace what is there with the style definitions shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-card/blog-card.component.scss

Add the BlogCardComponent to the home page

We will display the blog card on home page. Open src/app/components/home.component.html and replace what is there with the following HTML.

<div class="row left-panel">
    <div class="col-md-9">
        <app-blog-card></app-blog-card>
    </div>
</div>

Open src/app/components/home/home.component.scss and add the following style definition inside it.

.left-panel {
	margin-top: 15px;
}

Add Font Awesome and Material Icons libraries

We will add Font Awesome and Material Icons libraries in our application. We will use icon sets provided by these library for styling our app. Add the following lines in index.html file.

 <link  href="https://fonts.googleapis.com/icon?family=Material+Icons"  rel="stylesheet">
 <link rel="stylesheet" type="text/css"
href="https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css" />

Read a blog post

We will add the feature of reading a blog. Run the following command to create the blog component

ng g c components/blog

Add the router link for this component in app.module.ts as shown below

{ path: 'blog/:id/:slug', component: BlogComponent },

Add the following method definition in blog.service.ts file.

getPostbyId(postId: string) {
	const  userDetails = this.db.doc('blogs/' + postId).valueChanges();
	return  userDetails;
}

Open src/app/components/blog/blog.component.ts and add import definitions as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog/blog.component.ts#L2-L4

import { Post } from 'src/app/models/post';
import { ActivatedRoute } from '@angular/router';
import { BlogService } from 'src/app/services/blog.service';

Now put the code inside BlogComponent class as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog/blog.component.ts#L13-L30

Open src/app/components/blog/blog.component.html and replace what is there with the code shown below.

<div class="docs-example-viewer-wrapper">
    <h1 class="entry-title">{{postData.title}}</h1>
    <mat-card-subtitle class="blog-info">
        <i class="fa fa-calendar" aria-hidden="true"></i> {{postData.createdDate | date:'longDate'}}
    </mat-card-subtitle>
    <mat-divider></mat-divider>
    <div class="docs-example-viewer-body">
        <div [innerHTML]="postData.content">
        </div>
    </div>
</div>

Finally we will add styling for BlogComponent. Open src/app/components/blog/blog.component.scss and replace what is there with the style definitions shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog/blog.component.scss

Delete a blog post

We will add the feature of deleting a blog. Add the following code in the src/app/services/blog.service.ts.

deletePost(blogID: string) {
	return  this.db.doc('blogs/' + blogID).delete();
}

Open src/app/components/blog-card/blog-card.component.ts and add the delete method definition as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-card/blog-card.component.ts#L50-L58

delete(postId) {
if (confirm('Are you sure')) {
  this.blogService.deletePost(postId).then(
    () => {
      alert("Blog deleted successfully");
    }
  );
 }
}

Deploy the app on Firebase Hosting

The next step is to deploy the app on firebase. We will follow the steps as shown below.

Step 1: Install firebase CLI tools via npm. Run the command as shown below.

npm install -g firebase-tools

Step 2: Run the following command to build the app in production configuration.

ng build --prod

Step 3: Open a command prompt window inside the /blogsite/dist folder. And run the following command to login using firebase.

firebase login

It will open a browser window and ask you to login into Firebase. Login using your Google account. Upon successful login navigate back to your CLI.

Step 4: Execute the following command to initialize the app

firebase init

This command will initialize a firebase project. You will be asked a set of questions. Answer them as shown below:

  • Are you ready to proceed? – Y
  • Which Firebase CLI features do you want to setup for this folder? – select Hosting
  • Please select an option - use an existing project.
  • Select a default Firebase project for this directory: Select your project name from the list.
  • What do you want to use as your public directory? – blogsite
  • Configure as a single-page app (rewrite all urls to /index.html)? – y
  • File blogsite/index.html already exists. Overwrite? – N

You will get a “Firebase initialization complete!” message.

Step 4: Deploy on Firebase. Run the following command to deploy your application on Firebase.

firebase deploy

This command will deploy your angular application on Firebase and upon success it will give you a hosting URL. Navigate to the hosting URL to see your deployed app in action.

You can also find the hosting URL on firebase dashboard. Navigate to the "Project Overview" page of your Firebase project. Select “Hosting” under “Develop” menu from the list on the left. You can see the domain names for your web app in the panel on the right.

Edit an existing blog post

We will now implement the functionality to edit an existing blog. Add the following code definition in blog.service.ts.

updatePost(postId: string, post: Post) {
	const  putData = JSON.parse(JSON.stringify(post));
	return  this.db.doc('blogs/' + postId).update(putData);
}

Add the routing for edit functionality in app.module.ts as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/app.module.ts#L51

RouterModule.forRoot([
  ...
  { path: 'editpost/:id', component: BlogEditorComponent },
  ...
])

We will fetch the id of the blog from the URL with the help of ActivatedRoute class. Open blog-editor.component.ts and add the following code in the constructor.

if (this._route.snapshot.params['id']) {
	this.postId = this._route.snapshot.paramMap.get('id');
}

Update the ngOnInit method inside the BlogEditorComponent class as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-editor/blog-editor.component.ts#L31-L43

ngOnInit() {
this.setEditorConfig();
if (this.postId) {
  this.formTitle = 'Edit';
  this.blogService.getPostbyId(this.postId).subscribe(
	(result: Post) => {
	  if (result) {
		this.setPostFormData(result);
	  }
	}
  );
 }
}

We will add the method to set the edit form when we click on “Edit” button on blog card in the home page. The method definition is shown below.

setPostFormData(postFormData) {
	this.postData.title = postFormData.title;
	this.postData.content = postFormData.content;
}

Upon clicking on Save we need to handle to case of both adding a new blog as well as editing an existing blog. Hence we will update the saveBlogPost as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-editor/blog-editor.component.ts#L68-L83

saveBlogPost() {
if (this.postId) {
  this.blogService.updatePost(this.postId, this.postData).then(
    () => {
      this._router.navigate(['/']);
    }
  );
} else {
  this.postData.createdDate = this.datePipe.transform(Date.now(), 'MM-dd-yyyy HH:mm');
  this.blogService.createPost(this.postData).then(
    () => {
      this._router.navigate(['/']);
    }
  );
 }
}

Pagination on the home page

We will add the feature of pagination on the home page. We will use ngx-pagination for this purpose.

Execute the command shown below to install the ngx-pagination component for Angular.

npm i ngx-pagination

Import the NgxPaginationModule in src/app/app.module.ts as shown below.

import { NgxPaginationModule } from  'ngx-pagination';

@NgModule( {
  imports: [
    ...
    NgxPaginationModule,
  ],
})

Create the PaginatorComponent

Run the following command, in the original terminal, to generate a Paginator component.

ng g c components/paginator

Open src/app/components/paginator/paginator.component.ts and add import definitions as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/paginator/paginator.component.ts#L1-L2

import { Component, Input } from '@angular/core';
import { Router } from '@angular/router';

We will add two Input property for this component as shown below.

@Input()
pageSizeOptions: [];

@Input()
config: any;

Inject the Router class in the constructor as shown below.

constructor(private  router:  Router) { }

We will add the method to handle the pageChange event for our paginator. The definition for this method can be found at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/paginator/paginator.component.ts#L19-L21

pageChange(newPage: number) {
  this.router.navigate(['/page/', newPage]);
}

We will add another method to setup dynamic page size for the paginator. This method will set the number of items to show on each page based on selection from a drop down list. The method definition can be found at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/paginator/paginator.component.ts#L23-L26

changePageItemCount(selectedItem) {
  localStorage.setItem('pageSize', selectedItem.value);
  this.config.itemsPerPage = selectedItem.value;
}

Open src/app/components/paginator/paginator.component.html and replace what is there with the code shown below.

<div class="paginator-controls">
<div>
    <pagination-controls (pageChange)="pageChange($event)" class="my-pagination"></pagination-controls>
</div>
<div>
    <mat-form-field>
        <mat-label>Items per page: </mat-label>
        <mat-select [(ngModel)]="config.itemsPerPage" (selectionChange)="changePageItemCount($event)">
            <mat-option *ngFor="let page of pageSizeOptions" [value]="page">
                {{ page }}
            </mat-option>
        </mat-select>
    </mat-form-field>
</div>

Finally we will add styling for PaginatorComponent. Open src/app/components/paginator/paginator.component.scss and replace what is there with the style definitions shown below.

.my-pagination ::ng-deep .ngx-pagination {
    margin: 10px 0px 10px 0px;
    padding-inline-start: 0px;
 }
 .paginator-controls {
    display: flex;
    justify-content: space-between;
    padding-top: 10px;
 }
 @media screen and (min-width: 320px) and  (max-width: 420px) {
    .paginator-controls {
      flex-direction: column-reverse;
 }
}

Now we will add a new router link in app.module.ts to support the pagination as shown below.

{ path: 'page/:pagenum', component: HomeComponent },

Add the PaginatorComponent to the BlogCard

To enable pagination, we need to add the PaginatorComponent to the BlogCardComponent. Open src/app/components/blog-card.component.ts and declare two properties as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-card/blog-card.component.ts#L15-L16

config: any;
pageSizeOptions = [];

Add the import for ActivatedRoute in the component as shown below.

import { ActivatedRoute } from  '@angular/router';

Inject the ActivatedRoute class in the constructor as shown below

private  route:  ActivatedRoute,

We will initialize the newly declared properties inside the constructor as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-card/blog-card.component.ts#L27-L32

this.pageSizeOptions = [2, 4, 6];
const pageSize = localStorage.getItem('pageSize');
this.config = {
  currentPage: 1,
  itemsPerPage: pageSize ? +pageSize : this.pageSizeOptions[0]
};

Now update the ngOnInit method as shown below.

 ngOnInit() {
 this.route.params.subscribe(
  params => {
    this.config.currentPage = +params['pagenum'];
    this.getBlogPosts();
  }
 );
}

Update the BlogCardComponent template

Open src/app/components/blog-card.component.html and add the paginator component as shown below.

<app-paginator [pageSizeOptions]="pageSizeOptions" [config]="config"></app-paginator>

We will also add a paginate pipe in our ngFor directive while iterating through the list of blog posts as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/blog-card/blog-card.component.html#L7

<div  *ngFor="let post of blogPost | paginate: config">

Test the pagination feature

Open the browser and you can see a paginator on the home page. You can jump through the pages and the URL will change with the updated page number. You can also see a drop down list besides the paginator which will allow you to select the number of items to show on each page.

Add Google authentication

We will add the feature of login with Google account into our application. We have to enable the authentication feature from Firebase console. Follow the steps mentioned below to enable Google authentication on Firebase.

  • Navigate to the "Project Overview" page of your Firebase project.
  • Select “Authentication” under “Develop” menu from the list on the left.
  • Navigate to "Sign-in method" tab.
  • Click on "Google" from the available list of "Sign-in providers" on the page.
  • Click on Enable toogle button then click on "Save"

Next we will configure our application for the Google authentication.

Creating the AppUser model

Create a new file src/app/models/appuser.ts and paste the following code.

export class AppUser {
    name: string;
    email: string;
    photoURL: string;
}

We will create a service to handle the authentication. Create a new service using the command shown below.

ng g s services/auth

Open the src/app/services/auth.service.ts file and add the following import definitions.

import { AppUser } from '../models/appuser';
import { Observable, of } from 'rxjs';
import { AngularFireAuth } from '@angular/fire/auth';
import { ActivatedRoute, Router } from '@angular/router';
import { AngularFirestore } from '@angular/fire/firestore';
import { switchMap } from 'rxjs/operators';
import * as firebase from 'firebase/app';

Declare an observable of type AppUser in the AuthService class as shown below.

appUser$:  Observable<AppUser>;

Inject the services in the constructor as shown below.

  constructor(
    public afAuth: AngularFireAuth,
    private route: ActivatedRoute,
    private router: Router,
    private db: AngularFirestore
 )

The observable appUser$ will get the auth state of the user. If the user is logged in, it will fetch the user details from the firestore database, else it will return null. Put the following code in the constructor as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/services/auth.service.ts#L24-L34

this.appUser$ = this.afAuth.authState.pipe(
  switchMap(user => {
	if (user) {
	  return this.db.doc<AppUser>(`appusers/${user.uid}`).valueChanges();
	} else {
	  return of(null);
	}
  })
);

Add the method definition for login and logout as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/services/auth.service.ts#L37-L51

async login() {
    const returnUrl = this.route.snapshot.queryParamMap.get('returnUrl') || this.router.url;
    localStorage.setItem('returnUrl', returnUrl);

    const credential = await this.afAuth.auth.signInWithPopup(new firebase.auth.GoogleAuthProvider());
    return this.updateUserData(credential.user);
  }

async logout() {
    await this.afAuth.auth.signOut().then(() => {
      this.router.navigate(['/']);
    });
  }

We will also add a method updateUserData to save the user data into our database upon successful login. We will store the name, email address and photoURL of the photo in Google account for each user in our database. You can get the method definition from https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/services/auth.service.ts#L54-L62

private updateUserData(user) {
    const userRef = this.db.doc(`appusers/${user.uid}`);
    const data = {
      name: user.displayName,
      email: user.email,
      photoURL: user.photoURL
    };
    return userRef.set(data, { merge: true });
}

Update AppComponent

Open src/app/app.component.ts and add the following import definitions at the top.

import { AuthService } from './services/auth.service';
import { Router } from '@angular/router';

Inject the services in the constructor as shown below.

constructor(
	private authService: AuthService,
	private router: Router
) { }

We will subscribe to the observable appUser$ in the constructor as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/app.component.ts#L16-L31

this.authService.appUser$.subscribe(user => {
  if (!user) {
	return;
  } else {
	const returnUrl = localStorage.getItem('returnUrl');
	if (!returnUrl) {
	  return;
	}
	localStorage.removeItem('returnUrl');
	this.router.navigateByUrl(returnUrl);
  }
});

Add Login button in Navigation bar

Open src/app/components/nav-bar/nav-bar.component.ts and add the following import definitions at the top.

import { AuthService } from 'src/app/services/auth.service';
import { AppUser } from 'src/app/models/appuser';

We will declare a property to hold the user data. We will also Inject the AuthService in the constructor. Refer to the code snippet shown below.

appUser:  AppUser;
constructor(private  authService:  AuthService) {}

We will subscribe to the observable appUser$ from AuthService and set the appUser property. Add the following line of code in the constructor.

authService.appUser$.subscribe(appUser  =>  this.appUser  =  appUser);

We will also add the method to handle login and logout from our application as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/nav-bar/nav-bar.component.ts#L18-L24

login() {
  this.authService.login();
}

logout() {
  this.authService.logout();
}

We will update the template for navigation bar. Open src/app/components/nav-bar/nav-bar.component.html and replace the content with the code shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/components/nav-bar/nav-bar.component.html

We will add the following style definition in src/app/components/nav-bar/nav-bar.component.scss

.user-avatar {
	height: 40px;
	width: 40px;
	border-radius: 50%;
	flex-shrink: 0;
}

Update App module

Import the AngularFireAuthModule into src/app/app.module.ts file as shown below.

import { AngularFireAuthModule } from  '@angular/fire/auth';

@NgModule({
  ...
  imports: [
    ...
    AngularFireAuthModule,
  ],
})

Authenticated access for Edit and Delete

Open src/app/components/blog-card.component.ts and add the following two import definitions at the top.

import { AppUser } from 'src/app/models/appuser';
import { AuthService } from 'src/app/services/auth.service';

Similar to Nav-bar component, we will declare a property in BlogCardComponent and Inject the AuthService in the constructor. Refer to the code snippet shown below.

appUser: AppUser;
constructor(private authService: AuthService) {}

We will subscribe to the observable appUser$ from AuthService and set the appUser property. Add the following line of code in the constructor.

this.authService.appUser$.subscribe(appUser  =>  this.appUser  =  appUser);

Open src/app/components/blog-card.component.html and add a ngIf directive to restrict the Edit and Delete functionality for logged in users only.

<ng-container *ngIf="appUser">

Secure your routes

We will add an auth guard to our application to restrict unauthorized access to certain routes. To create a new guard, run the command as shown below.

ng g g guards/auth

Open the src/app/guards/auth.guard.ts file and add the following import definitions.

import { AuthService } from '../services/auth.service';
import { map } from 'rxjs/operators';

Add a constructor and inject Router and AuthService in it as shown below.

constructor(
	private router: Router,
	private authService: AuthService
) { }

We will update the canActivate method to handle unauthenticated access as shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/guards/auth.guard.ts#L19-L25

return this.authService.appUser$.pipe(map(user => {
  if (user) {
	return true;
  }
  this.router.navigate(['/'], { queryParams: { returnUrl: state.url } });
  return false;
}));

Add route guards in App module

To activate route guard for a particular route, we need to add canActivate property for them in app.module.ts. We will secure the routes for Adding a new post and editing an existing post by adding canActivate property. The code is shown at https://github.com/AnkitSharma-007/blogsite/blob/master/src/app/app.module.ts#L50-L51

{ path: 'addpost', component: BlogEditorComponent, canActivate: [AuthGuard] },
{ path: 'editpost/:id', component: BlogEditorComponent, canActivate: [AuthGuard] },

Thus we have successfully configured Google authentication and implemented auth guards for our application.

This completes our application. We learned how to create a simple blogging application using Angular on frontend and cloud firestore as database.

Next Steps

We can extend this application by adding new features. Some of them are mentioned below.

  • Post comment on each blog
  • Option to share the blog on social media
  • Author profile on home page
  • Snackbar to show user friendly message

An advanced version of this app with all the new features is available at https://github.com/AnkitSharma-007/blogging-app-with-Angular-CloudFirestore

Personal blog

You can read articles on Angular on my personal blog at https://ankitsharmablogs.com/

Social Media

You can connect with me via social channels

Explore Angular in depth

If you want to explore Angular in depth then refer to https://angular.io/start

About

Mini-workshop for Angular Connect 2019

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published