foundational layer for inserting content and attachment links into content

core/api/endpoint/attachment_endpoint.go

@@ -40,7 +40,7 @@ func AttachmentDownload(w http.ResponseWriter, r *http.Request) {
 
 	params := mux.Vars(r)
 
-	attachment, err := p.GetAttachmentByJobAndFileID(params["orgID"], params["job"], params["fileID"])
+	attachment, err := p.GetAttachment(params["orgID"], params["attachmentID"])
 
 	if err == sql.ErrNoRows {
 		writeNotFoundError(w, method, params["fileID"])

core/api/endpoint/link_endpoint.go

@@ -0,0 +1,135 @@
+// Copyright 2016 Documize Inc. <legal@documize.com>. All rights reserved.
+//
+// This software (Documize Community Edition) is licensed under
+// GNU AGPL v3 http://www.gnu.org/licenses/agpl-3.0.en.html
+//
+// You can operate outside the AGPL restrictions by purchasing
+// Documize Enterprise Edition and obtaining a commercial license
+// by contacting <sales@documize.com>.
+//
+// https://documize.com
+
+package endpoint
+
+import (
+	"database/sql"
+	"encoding/json"
+	"net/http"
+
+	"github.com/gorilla/mux"
+
+	"github.com/documize/community/core/api/entity"
+	"github.com/documize/community/core/api/request"
+	"github.com/documize/community/core/api/util"
+)
+
+// GetLinkCandidates returns references to documents/sections/attachments.
+func GetLinkCandidates(w http.ResponseWriter, r *http.Request) {
+	method := "GetLinkCandidates"
+	p := request.GetPersister(r)
+
+	params := mux.Vars(r)
+	documentID := params["documentID"]
+	pageID := params["pageID"]
+
+	// parameter check
+	if len(documentID) == 0 {
+		util.WriteMissingDataError(w, method, "documentID")
+		return
+	}
+
+	if len(pageID) == 0 {
+		util.WriteMissingDataError(w, method, "pageID")
+		return
+	}
+
+	// permission check
+	if !p.CanViewDocument(documentID) {
+		util.WriteForbiddenError(w)
+		return
+	}
+
+	// We can link to a section within the same document so
+	// let's get all pages for the document and remove "us".
+	pages, err := p.GetPagesWithoutContent(documentID)
+
+	if err != nil && err != sql.ErrNoRows {
+		util.WriteServerError(w, method, err)
+		return
+	}
+
+	if len(pages) == 0 {
+		pages = []entity.Page{}
+	}
+
+	pc := []entity.LinkCandidate{}
+
+	for _, p := range pages {
+		if p.RefID != pageID {
+			c := entity.LinkCandidate{
+				RefID:      util.UniqueID(),
+				DocumentID: documentID,
+				PageID:     p.RefID,
+				LinkType:   "section",
+				Title:      p.Title,
+			}
+			pc = append(pc, c)
+		}
+	}
+
+	// We can link to attachment within the same document so
+	// let's get all attachments for the document.
+	files, err := p.GetAttachments(documentID)
+
+	if err != nil && err != sql.ErrNoRows {
+		util.WriteServerError(w, method, err)
+		return
+	}
+
+	if len(files) == 0 {
+		files = []entity.Attachment{}
+	}
+
+	fc := []entity.LinkCandidate{}
+
+	for _, f := range files {
+		c := entity.LinkCandidate{
+			RefID:        util.UniqueID(),
+			DocumentID:   documentID,
+			AttachmentID: f.RefID,
+			LinkType:     "file",
+			Title:        f.Filename,
+		}
+
+		fc = append(fc, c)
+	}
+
+	// send back the payload
+	var payload struct {
+		Pages       []entity.LinkCandidate `json:"pages"`
+		Attachments []entity.LinkCandidate `json:"attachments"`
+		Matches     []entity.LinkCandidate `json:"matches"`
+	}
+
+	payload.Pages = pc
+	payload.Attachments = fc
+
+	json, err := json.Marshal(payload)
+
+	if err != nil {
+		util.WriteMarshalError(w, err)
+		return
+	}
+
+	util.WriteSuccessBytes(w, json)
+}
+
+/*
+	DocumentID string `json:"documentId"`
+	PageID     string `json:"pageId"`
+	FileID     string `json:"fileId"`
+	LinkType   string `json:"linkType"`
+	Title      string `json:"caption"` // what we label the link
+	Context    string `json:"context"` // additional context (e.g. excerpt, parent)
+
+*/

core/api/endpoint/router.go

@@ -136,7 +136,7 @@ func init() {
 	log.IfErr(Add(RoutePrefixPublic, "forgot", []string{"POST", "OPTIONS"}, nil, ForgotUserPassword))
 	log.IfErr(Add(RoutePrefixPublic, "reset/{token}", []string{"POST", "OPTIONS"}, nil, ResetUserPassword))
 	log.IfErr(Add(RoutePrefixPublic, "share/{folderID}", []string{"POST", "OPTIONS"}, nil, AcceptSharedFolder))
-	log.IfErr(Add(RoutePrefixPublic, "attachments/{orgID}/{job}/{fileID}", []string{"GET", "OPTIONS"}, nil, AttachmentDownload))
+	log.IfErr(Add(RoutePrefixPublic, "attachments/{orgID}/{attachmentID}", []string{"GET", "OPTIONS"}, nil, AttachmentDownload))
 	log.IfErr(Add(RoutePrefixPublic, "version", []string{"GET", "OPTIONS"}, nil, version))
 
 	// **** add secure routes
@@ -212,12 +212,14 @@ func init() {
 	log.IfErr(Add(RoutePrefixPrivate, "sections", []string{"POST", "OPTIONS"}, nil, RunSectionCommand))
 	log.IfErr(Add(RoutePrefixPrivate, "sections/refresh", []string{"GET", "OPTIONS"}, nil, RefreshSections))
 
+	// Links
+	log.IfErr(Add(RoutePrefixPrivate, "links/{documentID}/{pageID}", []string{"GET", "OPTIONS"}, nil, GetLinkCandidates))
+
 	// Global installation-wide config
 	log.IfErr(Add(RoutePrefixPrivate, "global", []string{"GET", "OPTIONS"}, nil, GetGlobalConfig))
 	log.IfErr(Add(RoutePrefixPrivate, "global", []string{"PUT", "OPTIONS"}, nil, SaveGlobalConfig))
 
-	// **** configure single page app handler.
-
+	// Single page app handler
 	log.IfErr(Add(RoutePrefixRoot, "robots.txt", []string{"GET", "OPTIONS"}, nil, GetRobots))
 	log.IfErr(Add(RoutePrefixRoot, "sitemap.xml", []string{"GET", "OPTIONS"}, nil, GetSitemap))
 	log.IfErr(Add(RoutePrefixRoot, "{rest:.*}", nil, nil, web.EmberHandler))